Bounded modules mapped across runtime, content, projects, billing, and integrations.
Read
Explore the platform in the order people actually need it.
Start with the platform framing, move into capabilities and workflows, then drop into architecture and reference pages when you need implementation detail.
Overview
Start with the product framing, platform map, and the shortest path to a working stack.
Features
See the major surfaces: agent runtime, chat, content generation, connectors, billing, and deployment.
Getting Started
Boot the repo with `make setup`, configure models, and choose the right local or Docker mode.
Architecture
Understand the domain map, request flow, event system, and contributor patterns.
Reference
Use the commands guide and environment reference when you need exact setup details.
Map
What lives in this repo
II-Agent is not just one runtime loop. The codebase combines execution, persistence, realtime transport, content systems, external integrations, and deployment primitives.
Build
Agent mode, project design, Cloud Run deployment, files, connectors, and multi-step execution.
Create
Slides, storybooks, media generation, Nano Banana flows, and prompt-to-content pipelines.
Operate
Billing, credits, settings, Socket.IO orchestration, docs tooling, tests, and stack operations.
Quick start
The shortest route to a working local stack
The repo supports two main loops: host-native development with Docker-backed infrastructure, and a fuller containerized stack for parity testing.
Keep the first pass simple: wire models, boot the stack, verify health, then branch into the deeper docs surfaces only where needed.
- Run `make setup` to create `.env` files and install dependencies.
- Choose a model source with `MODEL_CONFIGS` or `MODEL_CONFIGS_FILE`.
- Use `make dev-all` for the fast local loop or `make stack-build` for the full containerized stack.
- Verify the backend at `http://localhost:8000/health` and the frontend at `http://localhost:1420`.