nasim — a CLI code agent + HTTP API server + MCP server, designed from first principles with a full C4 → code design chain.
- Code assistance — read, write, edit files; search code and web; run shell commands; manage git operations
- Multi-interface — CLI (REPL), HTTP API (FastAPI + SSE), and MCP server from a single agent core
- Multi-provider — Ollama, OpenAI, Anthropic, and 100+ LLM backends via litellm
- Safety-first — permission gates, sandboxed execution, injection scanning
- Extensible — plugin system, hook system, MCP tool integration
Design-chain phase (C4 → UC → SM → SQ → ERD → CL → CT/DATA → CT/API → Code)
is in draft under docs/. Implementation has not yet begun. CI-CD is in plan
step across the whole project.
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
bash scripts/lint.shSee docs/RDM/ for the implementation roadmap.
| Directory | Contents |
|---|---|
| docs/C4/ | 24 C4 architecture diagrams |
| docs/UC/ | 148 use cases across 21 groups |
| docs/SM/ | 4 state machine diagrams |
| docs/SQ/ | 148 sequence diagrams |
| docs/ER/ | 5 entity-relationship diagrams |
| docs/CL/ | Runtime class model |
| docs/CT/ | Data contracts (ODCS v3.1.0) + HTTP API (OAS 3.1.0) |
| docs/RDM/ | Implementation roadmap |
| docs/MM/ | Design chain maps |
Apache 2.0 — see LICENSE.