https://github.com/achetronic/magec
Multi-agent AI platform with voice and text control. Visual workflows, web interface, and chat integrations (Telegram, Discord, Slack). Long-term memory, any LLM backend, extensible via MCP tools.
https://github.com/achetronic/magec
ai-assistant ai-workflows long-term-memory magec mcp-servers session-memory voice-control
Last synced: 24 days ago
JSON representation
Multi-agent AI platform with voice and text control. Visual workflows, web interface, and chat integrations (Telegram, Discord, Slack). Long-term memory, any LLM backend, extensible via MCP tools.
- Host: GitHub
- URL: https://github.com/achetronic/magec
- Owner: achetronic
- License: apache-2.0
- Created: 2026-01-18T01:46:57.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-02-20T02:53:39.000Z (about 1 month ago)
- Last Synced: 2026-02-20T05:55:49.673Z (about 1 month ago)
- Topics: ai-assistant, ai-workflows, long-term-memory, magec, mcp-servers, session-memory, voice-control
- Language: HTML
- Homepage: https://magec.dev
- Size: 3.29 MB
- Stars: 20
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Magec
Self-hosted multi-agent AI platform with voice, visual workflows, and tool integration.
Website ·
Docs ·
Quick Start
---
Define multiple AI agents, each with its own LLM, memory, and tools. Chain them into multi-step workflows. Access via voice, Telegram, webhooks, or cron. Manage it all from a visual admin panel.
Your server, your data, your rules.
## Quick Start
### One-line install (fully local, no API keys)
```bash
curl -fsSL https://raw.githubusercontent.com/achetronic/magec/master/scripts/install.sh | bash
```
Downloads a Docker Compose file with everything: LLM (Ollama), STT (Parakeet), TTS (Edge TTS), embeddings, Redis, PostgreSQL. Add `--gpu` for NVIDIA acceleration.
### Docker with OpenAI (minimal)
```bash
docker run -d --name magec \
-p 8080:8080 -p 8081:8081 \
-v $(pwd)/config.yaml:/app/config.yaml \
-v magec_data:/app/data \
ghcr.io/achetronic/magec:latest
```
Create backends, agents, and clients from the Admin UI. See the [Docker Quick Start](https://achetronic.github.io/magec/docs/install-docker/) guide.
### Binary
Download from [Releases](https://github.com/achetronic/magec/releases), extract, and run:
```bash
./magec --config config.yaml
```
Ideal for local MCP tools (filesystem, git, shell). See the [Binary Installation](https://achetronic.github.io/magec/docs/install-binary/) guide.
---
**Admin UI** → http://localhost:8081 · **Voice UI** → http://localhost:8080
## Highlights
- **Multi-agent** — Per-agent LLM, memory, voice, and tools. Hot-reload from the Admin UI.
- **Agentic Flows** — Visual drag-and-drop editor. Sequential, parallel, loop, nested.
- **Any backend** — OpenAI, Anthropic, Gemini, Ollama, or any OpenAI-compatible API.
- **MCP tools** — Home Assistant, GitHub, databases, and hundreds more via Model Context Protocol.
- **Memory** — Session (Redis) + long-term semantic (PostgreSQL/pgvector).
- **Voice** — Wake word, VAD, STT, TTS. All server-side via ONNX Runtime. Privacy-first.
- **Clients** — Voice UI (PWA), Admin UI, Telegram, webhooks, cron, REST API, Slack.
## Screenshots
See all screenshots in the [documentation](https://achetronic.github.io/magec/docs/screenshots/).
## Roadmap
- [x] Multi-agent system with per-agent LLM, memory, and tools
- [x] Visual flow editor (sequential, parallel, loop, nested)
- [x] MCP tool integration (HTTP + stdio transports)
- [x] Voice UI with wake word detection and VAD
- [x] Telegram client with voice support
- [x] Long-term semantic memory (pgvector)
- [x] Session memory (Redis)
- [x] Webhook and cron clients
- [x] Admin UI with hot-reload
- [x] Secrets management (encrypted storage for API keys and sensitive credentials)
- [x] Slack client
- [x] Context window management — automatic summarization when approaching token limits (experimental)
- [ ] Discord client
- [ ] Expose agents and flows with A2a (Agent-to-agent) protocol
## Documentation
Full docs at **[magec.dev/docs](https://magec.dev/docs/)** — installation, configuration, agents, flows, backends, memory, MCP tools, clients, voice system, and API reference.
## Development
### Requirements
- Go 1.25+
- Node.js 22+ (for UI builds)
- Docker (for infrastructure services)
### Make commands
| Command | Description |
| -------------------- | --------------------------------------------------------- |
| `make build` | Build frontend UIs + embed models + compile server binary |
| `make dev` | Build all and start server |
| `make dev-admin` | Start Admin UI dev server (Vite, hot-reload) |
| `make dev-voice` | Start Voice UI dev server (Vite, hot-reload) |
| `make swagger` | Regenerate Swagger docs |
| `make infra` | Start PostgreSQL + Redis |
| `make ollama` | Start Ollama with qwen3:8b + nomic-embed-text |
| `make docker-build` | Build Docker image (current arch) |
| `make docker-buildx` | Build multi-arch image (amd64 + arm64) |
| `make clean` | Remove build artifacts |
### Key dependencies
| Dependency | Purpose |
| ----------------------------------------------------------------------------- | -------------------------------- |
| [google.golang.org/adk](https://pkg.go.dev/google.golang.org/adk) | Google Agent Development Kit |
| [modelcontextprotocol/go-sdk](https://github.com/modelcontextprotocol/go-sdk) | MCP client |
| [yalue/onnxruntime_go](https://github.com/yalue/onnxruntime_go) | ONNX Runtime for wake word / VAD |
| [mymmrac/telego](https://github.com/mymmrac/telego) | Telegram bot |
| [achetronic/adk-utils-go](https://github.com/achetronic/adk-utils-go) | ADK providers, session, memory |
## Special Mentions
| Who | What |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [@travisvn](https://github.com/travisvn) | Built the ARM64 Docker image for [OpenAI Edge TTS](https://github.com/travisvn/openai-edge-tts) in record time. This is the local TTS service we recommend — it exposes an OpenAI-compatible API (`/v1/audio/speech`) that uses Microsoft Edge's free neural voices under the hood, so Magec can use it as a drop-in replacement for OpenAI TTS. |
## Contributors
## License
[Apache 2.0](LICENSE) — Alby Hernández
---
If you find Magec useful, please ⭐ star this repo — it helps a lot.