378d599125
Multi-agent AI automation system with shared message bus, specialized roles (coder/researcher/reviewer), and deny-by-default security. - Config system with Pydantic validation and YAML loading - Async message bus with inter-agent delegation - LLM providers: Anthropic (Claude) and LiteLLM (DeepSeek/Kimi/MiniMax) - Tool system: registry, builtins (file/bash/web), approval engine, MCP client - Agent engine with tool-calling loop and orchestrator for multi-agent management - CLI channel (REPL) and Discord channel - Docker + Dockge deployment config - Typer CLI: chat, serve, status, agents commands Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
43 lines
1003 B
Markdown
43 lines
1003 B
Markdown
# xtrm-agent
|
|
|
|
Multi-agent AI automation system with shared message bus, specialized roles, and deny-by-default security.
|
|
|
|
## Architecture
|
|
|
|
Multiple specialized agents share a message bus and can delegate to each other:
|
|
|
|
- **Coder Agent** — Claude, file+bash tools, coding-focused
|
|
- **Researcher Agent** — DeepSeek/Kimi, web tools, research-focused
|
|
- **Reviewer Agent** — Claude, read-only tools, code review
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Install
|
|
uv sync
|
|
|
|
# Interactive chat (default: coder agent)
|
|
uv run xtrm-agent chat
|
|
|
|
# Target a specific agent
|
|
uv run xtrm-agent chat --agent researcher
|
|
|
|
# Single-shot message
|
|
uv run xtrm-agent chat -m "write a hello world script"
|
|
|
|
# Run all agents + Discord bot
|
|
uv run xtrm-agent serve
|
|
|
|
# Show status
|
|
uv run xtrm-agent status
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Edit `config.yaml` to configure providers, agents, tools, and channels.
|
|
Agent definitions live in `agents/*.md` with YAML frontmatter.
|
|
|
|
## Deployment
|
|
|
|
Deploy via Dockge on Unraid using the included `compose.yaml`.
|