Agent DJ

Self-hosted AI agent platform. One command, beautiful dashboard, 8 providers, multi-agent orchestration.

npx agent-dj@latest

Bring your own API key. Supports Claude, GPT, Gemini, Grok, Mistral, DeepSeek, Groq, and Ollama (local/free). No cloud accounts, no sign-ups — runs entirely on your machine. Apache-2.0.

What you get:

• Beautiful web dashboard at localhost
• 8 LLM providers — Claude, GPT-4o, Gemini, Grok, Mistral, DeepSeek, Groq, Ollama
• Multi-agent system — orchestrator auto-routes to specialist agents (Coder, Researcher, Writer, System, RAG)
• Knowledge base with RAG — upload documents, agents search them automatically
• MCP support — connect external tools (GitHub, Slack, databases, etc.)
• Skills — create custom instructions that shape how all agents behave
• Memory — agents remember context across conversations
• Full audit log of every action
• Permission system — control what agents can do

BYOK (Bring Your Own Key). Your keys, your data, your machine. Nothing leaves localhost unless you tell it to.

Quick Start

npx agent-dj@latest

On first run, the setup wizard walks you through choosing a provider and entering your API key. Then the dashboard opens automatically at http://localhost:3456.

You can also install globally:

npm install -g agent-dj
agent-dj

Features

• Multi-agent orchestration (Coder, Researcher, Writer, System, RAG)
• Chat interface with conversation history
• Skills system (custom instructions for all agents, works across all providers)
• Memory system (user context, feedback, projects)
• Knowledge base with RAG (document upload, hybrid search)
• MCP (Model Context Protocol) server support
• Permission system for file/command access
• Audit log for all agent actions
• Beautiful dashboard UI (React + Tailwind)

Supported Providers

| Provider | Auth | Notes | |----------|------|-------| | Anthropic | API key or OAuth token | Claude Opus, Sonnet, Haiku | | OpenAI | API key | GPT-4o, o1, o3-mini | | Google | API key | Gemini 2.0 Flash/Pro | | xAI | API key | Grok-3 | | Mistral | API key | Mistral Large | | DeepSeek | API key | DeepSeek Chat | | Groq | API key | Llama 3.3 70B (fast, free tier) | | Ollama | None | Local models, free |

Setup & Authentication

Option A: API Key (any provider)

agent-dj setup
# Choose provider → paste API key → pick model → done

Option B: Anthropic Max/Pro OAuth Token

Use your existing Claude Max or Pro subscription — no API credits needed.

# 1. Install Claude Code CLI and login
npm install -g @anthropic-ai/claude-code
claude login

# 2. Run setup — auto-detects your OAuth token
agent-dj setup

Commands

agent-dj              # Setup (if needed) + start server
agent-dj setup        # Interactive setup wizard
agent-dj start        # Start server + dashboard
agent-dj start -p 8080  # Custom port
agent-dj config       # Show current configuration

Dashboard: http://localhost:3456

Local Development

git clone https://github.com/Djumabaevs/action-agent.git
cd action-agent
npm install
cd web && npm install && cd ..

# Dev mode (server with watch)
npx tsx src/cli/index.ts start

# Build
npm run build

# Run tests
npm test

MCP Integration

Connect external MCP servers via the dashboard (Settings > MCP Servers) or config file at ~/.agent-dj/config.json:

{
  "mcpServers": [
    {
      "id": "my-server",
      "name": "My MCP Server",
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"]
    }
  ]
}

Connected MCP tools are automatically available to all agents.

Knowledge Base (RAG)

Upload documents via the dashboard Knowledge page or use the chat:

• "search knowledge base for deployment guide"
• "ingest this document into the knowledge base"

Supports: plain text, markdown, code files, PDF, DOCX.

Project Structure

agent-dj/
├── src/
│   ├── cli/           # CLI commands (setup, start)
│   ├── llm/           # LLM provider integration
│   ├── agent/         # Agent definitions & orchestrator
│   ├── server/        # Hono API server & routes
│   ├── db/            # SQLite database
│   ├── memory/        # Memory system
│   ├── rag/           # RAG (knowledge base)
│   ├── mcp/           # MCP client/server
│   ├── tools/         # Built-in tools (file, shell, web)
│   └── permissions/   # Permission management
├── web/               # React dashboard (Vite + Tailwind)
├── tests/             # Test suite (vitest)
└── package.json

Configuration

Config stored at ~/.agent-dj/config.json. Data (SQLite DB, memory, knowledge) stored in ~/.agent-dj/.

License

Apache-2.0