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>
This commit is contained in:
42
README.md
Normal file
42
README.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user