Contributing

We welcome contributions to ContextOS!

ContextOS is an open-source project. We welcome bug reports, feature requests, and pull requests.

Development Setup

To set up ContextOS for local development:

# 1. Clone the repository
git clone https://github.com/contextos/context-orchestrator.git
cd context-orchestrator

# 2. Create a virtual environment
python -m venv .venv
source .venv/bin/activate

# 3. Install dependencies
pip install -e ".[dev]"

# 4. Start the test database
docker compose up -d

# 5. Run migrations
alembic upgrade head

Running Tests

We use pytest for testing. Ensure the test database is running before executing tests.

pytest