AlphaSwarm Monorepo Paths
Status: active.
Canonical path contract for this repository. Sibling repos (rpi_kubernetes,
theia-ide, alphaswarm_platform_admin) mirror this table in their own
alphaswarm_docs/alphaswarm-monorepo-paths.md files.
| AlphaSwarm responsibility | Path |
|---|---|
| Control plane | alphaswarm_controller/ |
| Shared platform contracts | alphaswarm_core/ |
| Active client (Vite) | alphaswarm_client/ |
| Bot runtime/templates | alphaswarm_bots/ |
| RL subsystem | alphaswarm_rl/ (src/alphaswarm_rl/ source; 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/ |
| Monolith runtime | alphaswarm/ |
| Standalone operator CLI | alphaswarm_cli/ |
| 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/ (deprecation-warning import shim; pkgutil.walk_packages aliases every submodule under alphaswarm.rl.*) |
alphaswarm/ml/ | alphaswarm_models/src/alphaswarm_models/ (deprecation-warning import shim; pkgutil.walk_packages aliases every submodule under alphaswarm.ml.*) |
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/tasks/rl_tasks.py (Celery name= strings preserved for in-flight queue messages) |
alphaswarm/tasks/ml_tasks.py | alphaswarm_models/tasks/ml_tasks.py |
alphaswarm/tasks/ml_test_tasks.py | alphaswarm_models/tasks/ml_test_tasks.py |
alphaswarm/tasks/finetune_tasks.py | alphaswarm_models/tasks/finetune_tasks.py |
alphaswarm/tasks/training_tasks.py | alphaswarm_models/tasks/training_tasks.py |
alphaswarm/api/routes/rl.py | alphaswarm_rl/api/routes/rl.py (FastAPI mount path /rl unchanged) |
alphaswarm/api/routes/ml.py | alphaswarm_models/api/routes/ml.py (FastAPI mount path /ml unchanged) |
alphaswarm/api/routes/analytics_ml.py | 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/ |