Instead of installing Ballot Initiative on your local machine, you can run it in GitHub Codespaces, which provides a containerized development environment. Using Codespaces offers several advantages:
- Quick Setup – Get started instantly without manually configuring your development environment.
- Cross-Platform Compatibility – Work seamlessly from any operating system using a browser-based, cloud-hosted environment.
- Portability & Flexibility – Access your project from any device with a browser, eliminating dependency conflicts on your local machine.
- Navigate to Your Repository Settings
- In your forked repo of the Ballot Initiative Repo, click on the Settings tab.
- Access Codespaces Secrets
- In the left sidebar, scroll down to "Secrets and Variables" and click on "Codespaces".
- Click "New repository secret".
- Add a Secret
- In the "Name" field, enter
OPENAI_API_KEY. - In the "Value" field, paste your API key.
- Click "Add secret" to save it.
- Back on the repository's page, locate the green "Code" button near the top right corner of the page.
- Click on the "Create codespace on main" button.
The container will build and automatically launc the Ballot Initiative Application.





