go-magic: developer tool for Hermes Agent

Go AI agent framework inspired by Hermes Agent, with a TUI, web dashboard and messaging gateway

What go-magic does

go-magic, also called Magic Agent, is an AI agent framework written in Go and inspired by Nous Research's hermes-agent. It pairs a Go backend with a Vue 3 and TypeScript web dashboard and a BubbleTea terminal UI. The README lists support for more than 22 model providers, with several models per provider that can be switched without a restart, and over 15 built-in tools covering web, files, terminal, browser, code execution, memory, skills and MCP.

Many ideas mirror Hermes Agent: SOUL.md and USER.md memory files, skills created and loaded progressively from usage patterns, a messaging gateway for platforms such as Telegram, Discord, Slack, Feishu, WeChat and Matrix, a kanban board, cron jobs, and a Bot Mode of named agent profiles that can message each other. Bots on separate go-magic machines can talk over HTTP with a shared relay token. Sensitive values such as API keys are redacted in logs and outputs.

Key features

More than 22 model providers with hot-reload model switching
BubbleTea terminal UI and Vue 3 web dashboard
Built-in tools for web, files, terminal, browser, code execution and memory
Skills that are auto-created and loaded progressively
Messaging gateway covering Telegram, Discord, Slack, Feishu, WeChat, Matrix and more
Bot Mode with named agent profiles, cron routines and cross-machine peers

When to use it

Running a Hermes-style agent as a single Go binary
Operating several named bots that hand work to each other
Tracking token usage against a monthly budget from the CLI or dashboard

Who it is for: Go developers and users who like Hermes Agent's design and want a Go implementation with a similar feature set.

How it fits with Hermes Agent

An independent Go reimplementation inspired by Hermes Agent, not a fork. Its Bot Mode is described as inspired by Hermes Agent's Bot Mode, and it uses the same SOUL.md and USER.md file names.

How to install go-magic

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

go install github.com/magicwubiao/go-magic/cmd/magic@latest

Note: It is an independent reimplementation inspired by Hermes Agent, not a fork and not an official Nous Research project.

FAQ

What is go-magic?

go-magic is an AI agent framework written in Go and inspired by Nous Research's hermes-agent. It offers a terminal UI, a web dashboard, skills, memory, MCP support and a messaging gateway.

Does go-magic work with Hermes Agent?

It does not run Hermes Agent. It is a separate Go implementation that borrows Hermes concepts such as SOUL.md, USER.md, skills, Bot Mode and the messaging gateway.

How do I install go-magic?

Run go install github.com/magicwubiao/go-magic/cmd/magic@latest. The README also offers release binaries for Linux and macOS and a Docker image.