Python backend for Earthlink - autonomous agent training platform.

• Python 3.11+
• Docker and Docker Compose
• PostgreSQL with PostGIS extension
• Redis, ChromaDB, Ollama

See SETUP.md for comprehensive setup guide.

Initialize database:

python scripts/init_database.py

Start all services:

docker compose up -d

Start development server with hot reload:

docker compose up

Run tests:

pytest

Check code quality:

ruff check .
mypy src/

• OpenAPI docs: http://localhost:8000/docs
• Health checks: http://localhost:8000/health/status
• WebSocket commands: ws://localhost:8000/ws/commands/stream

Connect to PostgreSQL:

psql -h localhost -U earthlink -d earthlink

Run migrations:

alembic upgrade head

Create new migration:

alembic revision --autogenerate -m "description"

• scripts/init_database.py - Initialize database (extensions, tables, seed data)
• scripts/earthlink_cli.py - CLI tool for agent/simulation control

python scripts/earthlink_cli.py agent list
python scripts/earthlink_cli.py sim status
python scripts/earthlink_cli.py health

Configuration via environment variables. See docker-compose.yml for defaults.

MIT License - Copyright (c) 2025 William Sawyerr

See LICENSE file for details.