Files
xtrm-agent/README.md
Kaloyan Danchev 378d599125 Initial implementation of xtrm-agent multi-agent system
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>
2026-02-18 10:21:42 +02:00

1003 B

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.