Documentation

Overview

Go Micro is an agent harness and service framework for Go. A harness is the runtime around an agent: tools, memory, guardrails, workflows, state, discovery, and interop. Build an agent and it gets a model, memory, tools, planning, delegation, and service discovery; it is reachable over MCP and A2A. Write services and every endpoint becomes an AI-callable tool. Orchestrate the deterministic parts with durable flows. Agents, services, and flows come from the same primitives because an agent is a distributed system, and building one is building a service.

It’s built on a pluggable architecture of Go interfaces: service discovery, client/server RPC, pub/sub, plus auth, caching, and storage. Sane defaults out of the box, everything swappable.

Learn More

Start with Getting Started for install and the first local service. Then follow the first-agent on-ramp in the same order as the README: micro agent demo for the installed no-secret CLI affordance, micro agent quickcheck (or micro agent debug) for the short recovery map, micro examples for the provider-free examples map, micro zero-to-hero for the maintained lifecycle harness, examples wayfinding index for the runnable examples map, the smallest first-agent example for the fastest provider-free run, the 0→hero support reference for the full no-secret lifecycle example, No-secret first-agent transcript to run a mock-model support agent, Your First Agent to build a service-backed agent and talk to it with micro chat, Debugging your agent to use micro inspect agent <name> for runs and memory, and the 0→hero reference path to walk the full scaffold → run → chat → inspect → deploy dry-run lifecycle covered by CI.

Otherwise continue to read the docs for more information about the framework.

Contents

• Getting Started
• 0→hero Reference - Walk scaffold → run → chat → micro inspect agent <name> → deploy dry-run with CI-backed commands
• micro agent demo - Show the provider-free first-agent demo command and next docs steps
• micro agent quickcheck (alias: micro agent debug) - Show the stalled first-agent recovery map before the full debugging guide
• micro examples - Show provider-free first-agent examples in copy/paste order
• Examples wayfinding index - Choose the first-agent, support, and interop examples from one map
• Smallest first-agent example - Run one service-backed agent with a deterministic mock model
• 0→hero support reference - Run the maintained no-secret services → agents → workflows example
• No-secret first-agent transcript - Run the first useful agent path without a provider key
• Your First Agent - Build a service-backed agent and talk to it with micro chat
• MCP & AI Agents - Turn services into AI-callable tools with the Model Context Protocol
• CLI & Gateway Guide - Development vs Production modes
• micro loop quickstart - Scaffold an autonomous CI-gated improvement loop
• Quick Start
• Architecture
• Configuration
• Registry
• Broker
• Client/Server
• Transport
• Store
• Plugins
• Examples

Development & Deployment

• micro run - Local development with hot reload, API gateway, and agent playground
• micro build & deploy - Build binaries and deploy to production
• micro server - Optional production web dashboard with auth

AI & Agents

• 0→hero Reference - Walk scaffold → run → chat → micro inspect agent <name> → deploy dry-run with CI-backed commands
• No-secret first-agent transcript - Run the first useful agent path without a provider key
• Your First Agent - Build a service-backed agent and talk to it with micro chat
• Building AI-Native Services - End-to-end tutorial for MCP-enabled services
• MCP Security Guide - Auth, scopes, rate limiting, and audit logging
• Tool Description Best Practices - Writing docs that make agents effective
• Agent Integration Patterns - Multi-agent harness patterns and architectures

Advanced

• Framework Comparison - Including Go Micro vs Dapr for agents, services, and workflows
• Architecture Decisions
• Real-World Examples
• Migration Guides
• Observability
• micro loop quickstart
• Contributing
• Roadmap