Welcome to the Representative Finder Website, an innovative tool designed to help users discover their political representatives quickly and conveniently. This project was created for the 2024 Congressional App Challenge, aiming to increase political awareness and engagement using modern, accessible technology.
- Find Representatives: Users can input their location or click on a state to retrieve information about their representatives, including senators, governors, and other officials.
- Real-Time Data: Information on political figures is generated dynamically using Google Gemini and other APIs.
- User-Friendly Interface: A simple and intuitive design ensures accessibility for all users.
- Additional Resources: Access news and updates about U.S. politics to stay informed.
- Flask: Backend framework for handling requests and serving data.
- Google Gemini: For generating dynamic descriptions of political figures.
- GeoLookup: For location-based data retrieval.
- Google Civic Information API: For fetching official details about representatives.
- HTML/CSS: Frontend design and user interface.
- Bing Image Search API: To fetch images of political figures.
-
Clone the repository:
git clone https://github.com/yourusername/representative-finder.git cd representative-finder -
Install dependencies:
pip install -r requirements.txt
-
Set up environment variables for API keys:
palmApiKey: Google Gemini API key.openAiKey: OpenAI API key.googleCivicApiKey: Google Civic Information API key.flaskSecretKey: Flask secret key for sessions.
-
Run the server:
python main.py
-
Open your browser and navigate to
http://127.0.0.1:5000/.
We welcome contributions to enhance the website! Feel free to submit pull requests or report issues.
For inquiries or feedback, please contact [email protected].