Skip to main content

Overview

Overview

II-Agent

An agent platform for full-stack development, content generation, deep research, and multi-model chat, built on FastAPI, Socket.IO, SQLAlchemy, and a large tool surface.

Intelligent Internet mark

II-Agent is not a single assistant loop wrapped in a UI. It is a full product platform with realtime agent execution, REST chat APIs, project deployment primitives, slide and storybook pipelines, connector integrations, billing, persistent sessions, and a growing set of contributor workflows.

What It Does​

Start the stack

Bootstrap the repo, wire model configs, and choose the right local or Docker development mode.

Review capabilities

See the product surfaces across agents, chat, content, projects, billing, and integrations.

Study the architecture

Understand the domain map, startup path, request flow, and event system before changing code.

Use exact commands

Reference the make targets and operating commands for setup, stack management, docs, and tests.

How It Works​

  1. Users authenticate, create sessions, and choose either agent mode or chat mode.
  2. The backend coordinates model execution, tool selection, persistence, and billing.
  3. Socket.IO streams agent events in realtime while REST endpoints cover chat and domain APIs.
  4. Domain modules persist state across sessions, projects, files, slides, storybooks, connectors, and credits.
  5. Deployment and integration flows extend the platform beyond local execution.

Core Product Surfaces​

  • Full-stack app generation and iterative project editing.
  • Slides, storybooks, media templates, and AI-assisted content pipelines.
  • Deep research flows bridged into website and content generation workflows.
  • Multi-model chat with provider-backed settings and user preferences.
  • Cloud Run deployment, project databases, secrets, and custom subdomains.
  • Connectors, MCP settings, built-in skills, and prompt-enhancement services.
  • Credits, billing, usage tracking, and quality/testing discipline across the repo.

Quick Start​

make setup
cp model_configs.example.yaml model_configs.yaml
make dev-all
curl http://localhost:8000/health

Then open http://localhost:1420.

Repository Map​

21+Backend domains
27API route groups
21Realtime command handlers
38Core SQL tables

The main code areas are:

  • src/ii_agent/agents/ for runtime execution, tools, skills, and sandboxes
  • src/ii_agent/chat/ for REST chat and provider-backed messaging
  • src/ii_agent/content/ for slides, storybooks, and media
  • src/ii_agent/projects/ for deployable projects and Cloud Run support
  • src/ii_agent/integrations/ for connectors, mobile, and prompt enhancement
  • src/ii_agent/realtime/ for Socket.IO orchestration and event publication
  • src/ii_agent/core/ for shared config, DB, storage, Redis, and middleware

Start Here Next​

Showcase

See the hosted app, benchmark, and external proof points already attached to the project.

Product Overview

Review user personas, interaction modes, product pillars, and major user journeys.

Development Workflows

Choose between host-native development, infra-only mode, and the full Docker stack.

Agents

Inspect the tool families, runtime loop, skills model, and execution surfaces.