Mind Swarm is a multi-package workspace for an agent A-Life LLM experiment. This repository combines the Python execution engine, runtime assets, and several TypeScript user interfaces into a single root repository so the system can be developed and published together.

• mind-swarm-core - Python backend and execution engine built around FastAPI and agent runtime services
• mind-swarm-runtime - runtime agent definitions, knowledge packs, tools, and M-brain modules
• mind-swarm-hive - Python package for the question-driven collective intelligence layer
• mind-swarm-common-ui - shared TypeScript UI and transport utilities
• mind-swarm-cli-ui - terminal interface for interacting with the platform
• mind-swarm-web-ui - Vite/React web frontend
• mind-swarm-monitor - Vite/React monitoring dashboard
• mind-swarm-archive - archived sample run output kept as an example of a generated run

One archived run is intentionally kept under mind-swarm-archive as a reference example.

Use Python 3.10+ for the Python packages.

cd mind-swarm-core
python -m venv .venv
. .venv/Scripts/activate
pip install -e .[dev]

cd mind-swarm-hive
pip install -e .[dev]

Use Node.js 18+ for the TypeScript and React packages.

cd mind-swarm-common-ui
npm install
npm run build

cd mind-swarm-cli-ui
npm install
npm run build

cd mind-swarm-web-ui
npm install
npm run dev

cd mind-swarm-monitor
npm install
npm run dev

• Some package manifests and subproject documentation still reference their original standalone repositories.
• If this workspace is kept as the canonical repo, those internal repository URLs should be normalized in a follow-up cleanup.