II-Agent: a new open-source framework to build and deploy intelligent agents
# Add to your Claude Code skills
git clone https://github.com/Intelligent-Internet/ii-agentII-Agent is an open-source AI agent built for real work — now out of beta. 100% open source under the Apache-2.0 license.
Whether you're a solo developer, a research team, or an enterprise building internal tooling — you can run it, fork it, and extend it. No black boxes. No vendor lock-in. Bring your own API keys (BYOK) for full control over cost and model providers.
Try the web app | Join our Discord
https://github.com/user-attachments/assets/430425c4-2352-4101-9fdb-46bdfc63d26a
No comments yet. Be the first to share your thoughts!
| Domain | Capabilities | | :--- | :--- | | Chat | Multi-model conversations (switch providers mid-thread), file attachments, code interpreter, text file search | | Agent | General tasks with multi-step task planning | | Documents | PDF extraction & creation, Excel formulas & charts, Word editing, PowerPoint manipulation | | Slides | Prompt-to-deck creation with live collaborative editing and templates |
curl -LsSf https://astral.sh/uv/install.sh | sh# 1. Clone the repository
git clone https://github.com/Intelligent-Internet/ii-agent.git
cd ii-agent
# 2. Run first-time setup (creates .env files + installs deps)
make setup
# 3. Configure your LLM API keys
# Edit .env and set at least one LLM provider:
# Option A: Inline JSON in .env
# MODEL_CONFIGS='[{"model_id":"claude-sonnet-4-6","provider":"Anthropic","api_key":"sk-ant-...","display_name":"Claude Sonnet 4","is_default":true}]'
# Option B: YAML config file
# Copy model_configs.example.yaml to model_configs.yaml, fill in your keys,
# then set MODEL_CONFIGS_FILE=model_configs.yaml in .env
# 4. Start everything (infra + backend + frontend)
make dev-all
This starts:
| File | Created from | Purpose |
|------|-------------|---------|
| .env | .env.example | Backend config: database, Redis, storage, auth, LLM keys |
| frontend/.env | frontend/.env.example | Frontend config: API URL, Google OAuth, theme |
| model_configs.yaml | model_configs.example.yaml | LLM model definitions (alternative to inline JSON in .env) |
II-Agent supports multiple LLM providers. Configure them in model_configs.yaml or via MODEL_CONFIGS in .env:
| Provider | Example model_id | Notes |
|----------|-----------------|-------|
| OpenAI | gpt-5.4 | Requires api_key |
| Anthropic | claude-opus-4-6 | Direct API or Vertex AI |
| Google | gemini-3.1-pro-preview | Direct API or Vertex AI |
See model_configs.example.yaml for full configuration options including Vertex AI, Azure, and self-hosted models.
make help # Show all available commands
make dev-all # Start everything (infra + backend + frontend)
make infra # Start only Postgres, Redis, MinIO
make backend-dev # Start backend only (port 8000)
make frontend-dev # Start frontend only (port 5173)
make db-migrate # Run database migrations
make lint # Lint backend + frontend
make format # Auto-format backend + frontend
make test # Run all tests
make stack # Start full stack via Docker Compose
To run everything in Docker (no local Python/Node required):
# Copy and edit the stack env file
cp docker/.stack.env.example docker/.stack.env
# Edit docker/.stack.env with your credentials
make stack # Start full stack
make stack-build # Start with --build (rebuild images)
make stack-down # Stop and clean up
make stack-logs # Tail all logs
For more details, refer to our official guide
https://github.com/user-attachments/assets/d1fa7cde-06cc-4103-bed0-d4ad5e640de4