Local-first personal AI agent platform built on DeepAgents.

• 🤖 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

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

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

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

• 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

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

# Stop all services
.\stop.ps1

# Create config directory
mkdir -p ~/.ag3nt

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

cd apps/gateway
pnpm install
pnpm dev

Gateway runs on http://127.0.0.1:18789

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

cd apps/ui
npm install
npm run dev

UI runs on http://localhost:3000

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

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

• 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

MIT