go-magic

go-magic

Magic Agent -- A high-performance, ultra-lightweight AI Agent framework written in Go.

Overview

go-magic is a full-featured AI Agent framework that combines a powerful Go backend with a modern React/TypeScript web dashboard. It supports 20+ AI providers, ships a built-in TUI (BubbleTea), and offers extensive tooling for file operations, code execution, web browsing, and more.

Features

Multi-Provider Support (20+)

DeepSeek, OpenAI, Anthropic, Gemini, Ollama, OpenRouter, Groq, Mistral, Cohere, Perplexity, Together, DashScope, Kimi, MiniMax, Zhipu, Doubao (Volcano), Wenxin, Moonshot, Hunyuan, Mimo, and any OpenAI-compatible endpoint.

TUI Interface

Built with BubbleTea, featuring multi-line input, Markdown rendering, streaming output, and slash commands.

Coding Mode

A dedicated mode with relaxed permissions, longer timeouts, and support for Python/Node.js code execution -- designed for development workflows.

Web Dashboard

React/TypeScript frontend with real-time chat, session management, and configuration management. Embedded into the binary for single-file deployment.

Tool System

15+ built-in tools organized into toolsets:

Skills System

Auto-creation and progressive loading (L0/L1/L2). Skills are learned from usage patterns and can be shared via Skills Hub.

Messaging Gateway

Connect your agent to external platforms:

Telegram, Discord, Slack, WhatsApp, WeChat, WeCom, DingTalk, Feishu, QQ, LINE, Matrix.

MCP Protocol

Connect to external MCP (Model Context Protocol) servers to extend agent capabilities.

Session Management

SQLite-based persistence with FTS5 full-text search across all sessions.

CI/CD

GitHub Actions workflow for automatic multi-platform compilation and release.

Quick Start

Download Release

Download the latest binary from GitHub Releases:

# Linux / macOS
curl -L https://github.com/magicwubiao/go-magic/releases/latest/download/magic-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz | tar xz
chmod +x magic-*
sudo mv magic-* /usr/local/bin/magic

Go Install

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

Docker

# Quick run
docker run -it magicwubiao/go-magic

# With Docker Compose (includes optional Redis and PostgreSQL)
docker compose up -d

One-Line Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/magicwubiao/go-magic/main/scripts/install.sh | bash

First Run

# Interactive setup wizard
magic setup

# Start chatting
magic chat

TUI Slash Commands

Coding Mode

Switch to coding mode for development tasks:

/mode coding

Switch back with /mode chat.

Default Mode Configuration

Set the default startup mode in your config file so you don't need to switch manually every time:

{
  "chat_mode": "coding"
}

Available values: "chat" (default) or "coding".

You can also configure this via Web Dashboard → Config → General → Chat Mode.

After startup, you can still switch temporarily with /mode chat or /mode coding.

Web Dashboard

Start the web server:

magic server

Then open http://localhost:8642 in your browser.

Features:

• Real-time chat with streaming responses
• Session management (create, search, resume)
• Provider and model configuration
• Tool and skill management
• Token usage dashboard

Configuration

Create or edit ~/.magic/config.json:

{
  "profile": "default",
  "provider": "deepseek",
  "model": "deepseek-chat",
  "providers": {
    "deepseek": {
      "api_key": "your-deepseek-api-key",
      "model": "deepseek-chat"
    },
    "openai": {
      "api_key": "your-openai-api-key",
      "base_url": "https://api.openai.com/v1",
      "model": "gpt-4"
    },
    "anthropic": {
      "api_key": "your-anthropic-api-key",
      "model": "claude-3-opus-20240229"
    },
    "ollama": {
      "base_url": "http://localhost:11434",
      "model": "llama3"
    }
  },
  "tools": {
    "enabled": ["all"],
    "disabled": []
  },
  "gateway": {
    "enabled": false,
    "platforms": {
      "telegram": {
        "token": "your-telegram-bot-token",
        "enabled": false
      },
      "discord": {
        "token": "your-discord-bot-token",
        "enabled": false
      }
    }
  }
}

Environment Variables

Building from Source

Requirements

• Go 1.25+
• Node.js 20+ (for web dashboard)

Build for Current Platform

make build

Cross-Platform Build

# All common platforms (Linux, macOS, Windows)
make build-all

# All supported platforms
make build-cross

# Specific platform
make build-linux
make build-macos
make build-windows

Supported Platforms

GitHub Actions

Releases are built automatically via GitHub Actions when a version tag is pushed:

git tag v0.3.1
git push origin v0.3.1

The workflow builds binaries for Linux (amd64/arm64), macOS (amd64/arm64), and Windows (amd64), creates archives, and publishes a GitHub Release.

Download

Get the latest version from GitHub Releases.

License

MIT License -- see LICENSE for details.