Skip to content

zyrephus/politicate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ‡¨πŸ‡¦ Politicate πŸ‡¨πŸ‡¦

Empowering locals with simple, accessible political literacy

🌍 About Politicate

Politicate is a platform designed to make political education simple, accessible, and locally relevant. Staying informed about politics can be overwhelming, with complex policies, constant updates, and unclear information. Politicate breaks down these barriers by providing:

βœ… Personalized Political Insights – Enter your postal code to find your municipal, provincial, and federal representatives.
βœ… Policy Alignment Quiz – Discover where you stand politically by answering simple questions on key policies.
βœ… Localized Political News – Get curated news articles and updates relevant to your region.
βœ… AI-Powered News Assistant – Use an AI chatbot to summarize and ask questions about political news in a neutral, unbiased way.

Whether you're a student, a professional, or simply a concerned citizen, Politicate ensures that staying politically informed is easy and engaging.


Pre-requisites

Before running Politicate, make sure you have the following installed:

1️⃣ Install uv (Python Environment & Dependency Manager)

Official UV Installation Guide

curl -LsSf https://astral.sh/uv/install.sh | sh

2️⃣ Install npm (Node.js Package Manager)

Install Node.js from nodejs.org, which includes npm. Verify installation:

node -v   # Check Node.js version  
npm -v    # Check npm version  

Setup & Running Instructions

Backend (FastAPI) Setup

1️⃣ Navigate to the backend folder:

cd backend

2️⃣ Create a .env file inside backend/ and add the following:

PSE_API_KEY=your-api-key
GOOGLE_CLOUD_API_KEY=your-api-key
SUPABASE_PROJECT_URL=your-url
SUPABASE_API_KEY=your-api-key
SUPABASE_SERVICE_KEY=your-service-key
OPENAI_API_KEY=your-api-key

3️⃣ Install dependencies and run the backend:

uv run fastapi dev   # Start the FastAPI server  

The backend runs on http://localhost:8000.


Frontend Setup

1️⃣ Navigate to the frontend folder:

cd frontend

2️⃣ Create a .env.local file inside frontend/ and add the backend URL:

NEXT_PUBLIC_SUPABASE_URL=your-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-key

3️⃣ Install dependencies and start the frontend:

npm install
npm run dev

The frontend runs on http://localhost:3000.


License

This project is open-source under the MIT License.


πŸŽ‰ Now, You're Ready to Explore Politicate! πŸš€

About

Hack Canada 2025

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •