378d599125dd4f67337904c038ef2424a2f52ad5
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>
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
# 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.
Description
Languages
Python
99.9%
Dockerfile
0.1%