AlphaSwarm Monorepo Paths
Status: active (sibling-repo workspace; the physical split has been executed).
Canonical path contract for the shared workspace root. Each row is a
sibling repository (or a path inside one), not a subdirectory of
the alphaswarm monolith. Older docs that write alphaswarm_rl/ as
an in-tree path mean ../alphaswarm_rl next to ../alphaswarm.
| AlphaSwarm responsibility | Path |
|---|---|
| Control plane | alphaswarm_controller/ |
| Shared platform contracts | alphaswarm_core/ |
| Unified IAM hub | alphaswarm_auth/ |
| Active client (Vite) | alphaswarm_client/ |
| Bot runtime/templates | alphaswarm_bots/ |
| RL subsystem | alphaswarm_rl/ (src/alphaswarm_rl/ source incl. tasks/, api/routes/; configs/, tests/ siblings) |
| Custom model boundary | alphaswarm_models/ (src/alphaswarm_models/ source incl. serving/, tasks/, api/routes/; configs/, tests/ siblings) |
| Snippet corpus | alphaswarm_snippets/ (Retired) |
| Quant runtime (monolith) | alphaswarm/ |
| Standalone Agent runtime | alphaswarm_agents/ |
| Standalone operator CLI | alphaswarm_cli/ |
| Multi-cloud/SaaS FinOps | alphaswarm_finops/ |
| Platform Context MCP server | alphaswarm_mcp/ |
| Python Visualization dashboards | alphaswarm_viz/ |
| Agentic Assistant seeder | alphaswarm_assistant/ |
| Consolidated API Gateway | alphaswarm_api/ |
| Knowledge Base boundary | alphaswarm_kb/ |
| KB Federation reverse-proxy | alphaswarm_kb_federation/ |
| Ingestion connectors / marketplace | alphaswarm_ingest/ |
| Data Mesh federation gateway | alphaswarm_data_federation/ |
| Self-Organizing Knowledge Graph | alphaswarm_graph/ |
| Learning service | alphaswarm_learning/ |
| Customer PaaS Dashboard | alphaswarm_ui/ |
| Marketing website | alphaswarm_website/ |
| Local dev / simulation | alphaswarm_local/ |
| Distributed worker engine | alphaswarm_worker/ |
| Internal admin (services + accounts) | alphaswarm_admin/ |
| Vendored Theia IDE workspace | alphaswarm_ide/ |
| Curator-owned project index (SSoT) | alphaswarm_index/ |
| Canonical documentation | alphaswarm_docs/ |
| Hosted-platform single home | alphaswarm_platform/ |
| Kubernetes workloads | alphaswarm_platform/deployments/kubernetes/ |
| Terraform modules + environments | alphaswarm_platform/terraform/ |
| Multi-arch Dockerfiles + config gen | alphaswarm_platform/build/ |
| Legacy / edge component configs | alphaswarm_platform/deploy/ |
| Root-level compose files | alphaswarm_platform/compose/ |
| Multi-stage root Dockerfile | alphaswarm_platform/Dockerfile |
| Deployment topology YAML | alphaswarm_platform/configs/deployment/topology.yaml |
| Terraform stack YAMLs | alphaswarm_platform/configs/terraform/ |
| Cluster install scripts | alphaswarm_platform/scripts/cluster_install/ |
Compatibility stubs and historical paths (do not add active source here):
| Legacy path | Points to |
|---|---|
frontend/ | alphaswarm_client/ |
extractions/ | alphaswarm_snippets/extractions/ |
inspiration/ | alphaswarm_snippets/inspiration/ (ignored raw repos) |
alphaswarm/bots/ | alphaswarm_bots/ (import shim) |
alphaswarm/rl/ | alphaswarm_rl/src/alphaswarm_rl/ (shim removed from the monolith; import alphaswarm_rl.* directly — see alphaswarm/AGENTS.md) |
alphaswarm/ml/ | alphaswarm_models/src/alphaswarm_models/ (shim removed from the monolith; import alphaswarm_models.* directly — see alphaswarm/AGENTS.md) |
alphaswarm/llm/vllm_runner.py | alphaswarm_models/src/alphaswarm_models/serving/vllm.py (one-line re-export shim) |
alphaswarm/llm/ollama_client.py | alphaswarm_models/src/alphaswarm_models/serving/ollama.py (one-line re-export shim) |
alphaswarm/tasks/rl_tasks.py | alphaswarm_rl/src/alphaswarm_rl/tasks/rl_tasks.py (Celery name= strings preserved for in-flight queue messages) |
alphaswarm/tasks/ml_tasks.py | alphaswarm_models/src/alphaswarm_models/tasks/ml_tasks.py |
alphaswarm/tasks/ml_test_tasks.py | alphaswarm_models/src/alphaswarm_models/tasks/ml_test_tasks.py |
alphaswarm/tasks/finetune_tasks.py | alphaswarm_models/src/alphaswarm_models/tasks/finetune_tasks.py |
alphaswarm/tasks/training_tasks.py | alphaswarm_models/src/alphaswarm_models/tasks/training_tasks.py |
alphaswarm/api/routes/rl.py | alphaswarm_rl/src/alphaswarm_rl/api/routes/rl.py (FastAPI mount path /rl unchanged) |
alphaswarm/api/routes/ml.py | alphaswarm_models/src/alphaswarm_models/api/routes/ml.py (FastAPI mount path /ml unchanged) |
alphaswarm/api/routes/analytics_ml.py | alphaswarm_models/src/alphaswarm_models/api/routes/analytics_ml.py (FastAPI mount path /analytics/ml unchanged) |
configs/rl/ | alphaswarm_rl/configs/ |
configs/ml/ | alphaswarm_models/configs/ |
tests/rl/ | alphaswarm_rl/tests/ |
tests/ml/ | alphaswarm_models/tests/ |
docs/ | alphaswarm_docs/ (renamed; all references updated) |
root deployments/ | alphaswarm_platform/deployments/ |
root build/ | alphaswarm_platform/build/ |
root deploy/ | alphaswarm_platform/deploy/ |
root terraform/ | alphaswarm_platform/terraform/ |
root Dockerfile | alphaswarm_platform/Dockerfile |
root .dockerignore | alphaswarm_platform/.dockerignore |
root docker-compose.yml | alphaswarm_platform/compose/docker-compose.yml |
root docker-compose.platform.yml | alphaswarm_platform/compose/docker-compose.platform.yml |
root docker-compose.viz.yml | alphaswarm_platform/compose/docker-compose.viz.yml |
configs/deployment/ | alphaswarm_platform/configs/deployment/ |
configs/terraform/ | alphaswarm_platform/configs/terraform/ |
scripts/cluster_install/ | alphaswarm_platform/scripts/cluster_install/ |