AI Agentsagentagentic-aiaiai-agentai-agent-framework
Installation
# Add to your Claude Code skills
git clone https://github.com/Intelligent-Internet/ii-agent
README.md
II Agent
II-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.
# 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:
Backend at http://localhost:8000
Frontend at http://localhost:1420
PostgreSQL at localhost:5432
Redis at localhost:6379
MinIO (S3-compatible storage) at http://localhost:9001 (minioadmin/minioadmin)
Configuration Files
| 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) |
LLM Providers
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.
Useful Make Commands
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
Docker Compose (Full Stack)
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
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
