Description
Setting up the local development environment currently requires manually installing specific Python versions (such as Python 3.11) and managing dependencies locally. This manual setup introduces friction for new contributors, increases the likelihood of environment drift, and complicates working with local or cloud-based LLM providers like Ollama and Gemini.
Proposed Solution
Introduce a Docker and Docker Compose setup to containerize the application. This will provide:
- A standardized, isolated environment using a deterministic Python base image.
- Orchestration for external dependencies or local LLM instances (like Ollama) out of the box.
- Faster contributor onboarding with minimal local machine requirements.
Scope of Work
- Create a
Dockerfile with optimized dependency layers.
- Define a
docker-compose.yml to spin up the app and required sidecar services.
- Add a
.dockerignore file to keep the build context clean.
- Document the setup, configuration steps, and troubleshooting guidelines in a dedicated markdown file.
Additional Context
This will streamline the workflow for anyone who wants to quickly spin up the environment without messing with their global system dependencies.
Description
Setting up the local development environment currently requires manually installing specific Python versions (such as Python 3.11) and managing dependencies locally. This manual setup introduces friction for new contributors, increases the likelihood of environment drift, and complicates working with local or cloud-based LLM providers like Ollama and Gemini.
Proposed Solution
Introduce a Docker and Docker Compose setup to containerize the application. This will provide:
Scope of Work
Dockerfilewith optimized dependency layers.docker-compose.ymlto spin up the app and required sidecar services..dockerignorefile to keep the build context clean.Additional Context
This will streamline the workflow for anyone who wants to quickly spin up the environment without messing with their global system dependencies.