mcp server

AG3NT

Local-first multi-agent platform built on DeepAgents. Gateway, Agent Worker, and Web UI for orchestrating autonomous AI agents.

AP3X-Dev/AG3NTcommunitylistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

This project does not publish an install method we can turn into a config. Follow the README instead.

README

synced Oct 14, 2026

AG3NT

Local-first personal AI agent platform built on DeepAgents.

Features

🤖 Multi-Model Support - Anthropic, OpenAI, OpenRouter, Kimi, Google Gemini
🔌 Multi-Channel - CLI, TUI, Telegram, Discord adapters
🛠️ Agent Skills - Modular skill system with SKILL.md format
🌐 Browser Control - Playwright-based web automation (navigate, screenshot, click, fill)
🔒 Security - DM pairing, HITL approval for sensitive actions
⏰ Scheduler - Heartbeat checks and cron-based automation
🖥️ Multi-Node - Primary + companion device architecture

Repo Layout

ag3nt/
├── apps/
│   ├── gateway/     # Gateway daemon (HTTP + WebSocket + channels)
│   ├── agent/       # Agent worker (DeepAgents runtime)
│   ├── ui/          # Web dashboard (Next.js)
│   └── tui/         # Terminal UI client
├── skills/          # Bundled Agent Skills (SKILL.md format)
├── config/          # Default configuration templates
└── docs/            # Planning documents

🖥️ Web Dashboard

The AP3X-UI provides a comprehensive web interface for AG3NT:

Running the UI

Windows (Unified Script - Recommended):

.\start.ps1

This starts Gateway, Agent Worker, and UI together. Access at http://localhost:3000

Manual Start:

# Terminal 1: Start AG3NT Gateway
cd apps/gateway && npm run dev

# Terminal 2: Start AG3NT Agent Worker
cd apps/agent && .venv/Scripts/activate && python -m ag3nt_agent.worker

# Terminal 3: Start UI Dashboard
cd apps/ui && npm run dev

Access the dashboard at http://localhost:3000

UI Features

Real-time chat with streaming
Artifact library and management
Skills and tools browser
Subagent configuration
MCP server manager
Browser automation interface
System monitoring and logs

Quick Start

Windows (One Command)

# Start everything: Gateway + Agent + UI
.\start.ps1

# Stop all services
.\stop.ps1

Manual Setup

1. Copy Configuration

# Create config directory
mkdir -p ~/.ag3nt

# Copy default config
cp config/default-config.yaml ~/.ag3nt/config.yaml

2. Start Gateway

cd apps/gateway
pnpm install
pnpm dev

Gateway runs on http://127.0.0.1:18789

3. Start Agent Worker

cd apps/agent
python -m venv .venv

# Activate virtual environment
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

pip install -r requirements.txt
python -m ag3nt_agent.worker

Worker runs on http://127.0.0.1:18790

4. Start Web UI

cd apps/ui
npm install
npm run dev

UI runs on http://localhost:3000

5. Start TUI (Optional)

cd apps/tui
pip install -r requirements.txt
python ag3nt_tui.py

Milestone Status

Milestone	Status	Description
M1: Core Agent Runtime	✅ Complete	DeepAgents integration, multi-model support
M2: Modular Skill System	✅ Complete	SKILL.md format, skill discovery, execution runtime, trigger matching
M3: Gateway & Multi-Channel	✅ Complete	HTTP/WS API, Telegram/Discord adapters
M4: Planning & Memory	✅ Complete	TodoListMiddleware, memory persistence
M5: Secure Execution	✅ Complete	HITL approval flow, DM pairing security
M6: Scheduling	✅ Complete	Heartbeat system, cron jobs
M7: Multi-Node	✅ Complete	WebSocket protocol, pairing, capability routing
M8: Control Panel	✅ Complete	Web UI, skill management, debug logs

Active Development

See ROADMAP.md for detailed sprint planning and current priorities:

Core Tools: Shell execution, web search, git operations
Skill Execution: Runtime for skill entrypoints, MCP integration
Testing: Unit and E2E test coverage

Documentation

Agent Worker - Model providers and worker API
Web Dashboard - Next.js web interface
TUI Client - Terminal interface usage
Gateway API - HTTP/WebSocket API reference
Control Panel - Web-based control panel
Multi-Node Architecture - Companion device support
Skills - Skill format documentation

Environment Variables

Variable	Description	Default
`AG3NT_MODEL_PROVIDER`	LLM provider (anthropic, openai, openrouter, kimi, google)	`openrouter`
`AG3NT_MODEL_NAME`	Model name	`moonshotai/kimi-k2.5`
`ANTHROPIC_API_KEY`	Anthropic API key	-
`OPENAI_API_KEY`	OpenAI API key	-
`OPENROUTER_API_KEY`	OpenRouter API key	-
`KIMI_API_KEY`	Kimi/Moonshot API key	-
`GOOGLE_API_KEY`	Google Gemini API key	-

License

MIT