# Documentation LLMS index: [llms.txt](/llms.txt) --- # Docs Documentation for the Go Micro agent harness and service framework. ## Overview Go Micro architecture 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](https://modelcontextprotocol.io/) and [A2A](https://a2a-protocol.org). 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](getting-started.html) 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](https://github.com/micro/go-micro/blob/master/examples/INDEX.md) for the runnable examples map, [the smallest first-agent example](https://github.com/micro/go-micro/tree/master/examples/first-agent) for the fastest provider-free run, [the 0→hero support reference](https://github.com/micro/go-micro/tree/master/examples/support) for the full no-secret lifecycle example, [No-secret first-agent transcript](guides/no-secret-first-agent.html) to run a mock-model support agent, [Your First Agent](guides/your-first-agent.html) to build a service-backed agent and talk to it with `micro chat`, [Debugging your agent](guides/debugging-agents.html) to use `micro inspect agent ` for runs and memory, and the [0→hero reference path](guides/zero-to-hero.html) 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](getting-started.html) - [0→hero Reference](guides/zero-to-hero.html) - Walk scaffold → run → chat → `micro inspect agent ` → 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](https://github.com/micro/go-micro/blob/master/examples/INDEX.md) - Choose the first-agent, support, and interop examples from one map - [Smallest first-agent example](https://github.com/micro/go-micro/tree/master/examples/first-agent) - Run one service-backed agent with a deterministic mock model - [0→hero support reference](https://github.com/micro/go-micro/tree/master/examples/support) - Run the maintained no-secret services → agents → workflows example - [No-secret first-agent transcript](guides/no-secret-first-agent.html) - Run the first useful agent path without a provider key - [Your First Agent](guides/your-first-agent.html) - Build a service-backed agent and talk to it with `micro chat` - [MCP & AI Agents](mcp.html) - Turn services into AI-callable tools with the Model Context Protocol - [CLI & Gateway Guide](guides/cli-gateway.html) - Development vs Production modes - [`micro loop` quickstart](guides/micro-loop.html) - Scaffold an autonomous CI-gated improvement loop - [Quick Start](quickstart.html) - [Architecture](architecture.html) - [Configuration](config.html) - [Registry](registry.html) - [Broker](broker.html) - [Client/Server](client-server.html) - [Transport](transport.html) - [Store](store.html) - [Plugins](plugins.html) - [Examples](examples/) ## Development & Deployment - [micro run](guides/micro-run.html) - Local development with hot reload, API gateway, and agent playground - [micro build & deploy](deployment.html) - Build binaries and deploy to production - [micro server](server.html) - Optional production web dashboard with auth ## AI & Agents - [0→hero Reference](guides/zero-to-hero.html) - Walk scaffold → run → chat → `micro inspect agent ` → deploy dry-run with CI-backed commands - [No-secret first-agent transcript](guides/no-secret-first-agent.html) - Run the first useful agent path without a provider key - [Your First Agent](guides/your-first-agent.html) - Build a service-backed agent and talk to it with `micro chat` - [Building AI-Native Services](guides/ai-native-services.html) - End-to-end tutorial for MCP-enabled services - [MCP Security Guide](guides/mcp-security.html) - Auth, scopes, rate limiting, and audit logging - [Tool Description Best Practices](guides/tool-descriptions.html) - Writing docs that make agents effective - [Agent Integration Patterns](guides/agent-patterns.html) - Multi-agent harness patterns and architectures ## Advanced - [Framework Comparison](guides/comparison.html) - Including Go Micro vs Dapr for agents, services, and workflows - [Architecture Decisions](architecture/) - [Real-World Examples](examples/realworld/) - [Migration Guides](guides/migration/) - [Observability](observability.html) - [`micro loop` quickstart](guides/micro-loop.html) - [Contributing](contributing.html) - [Roadmap](roadmap.html) --- Section pages: - [Overview](/docs/overview/index.html): Go Micro is a framework for microservices development - [Interfaces](/docs/interfaces/index.html): Define interfaces to extend microservices - [Examples](/docs/examples/index.html): Learn by building real microservices with go-micro - [Guides](/docs/guides/index.html): Step-by-step guides for building with go-micro - [Project](/docs/project/index.html): Architecture, design, and getting involved - [AI Integration](/docs/ai-integration.html) - [Analysis: Removing Reflection from go-micro](/docs/reflection-removal-analysis.html) - [Architecture Decision Records](/docs/architecture.html) - [Broker](/docs/broker.html) - [Client/Server](/docs/client-server.html) - [Commercial Support](/docs/support.html) - [Configuration](/docs/config.html) - [Contributing](/docs/contributing.html) - [Deployment](/docs/deployment.html) - [Getting Started](/docs/getting-started.html) - [Go Micro Roadmap](/docs/roadmap-2026.html) - [Hosting](/docs/hosting.html) - [Micro Server (Optional)](/docs/server.html) - [Model Context Protocol (MCP)](/docs/mcp.html) - [Observability](/docs/observability.html) - [Performance Considerations](/docs/performance.html) - [Plugins](/docs/plugins.html) - [Quick Start](/docs/quickstart.html) - [Registry](/docs/registry.html) - [Roadmap](/docs/roadmap.html) - [Store](/docs/store.html) - [Summary: Reflection Removal Evaluation](/docs/reflection-evaluation-summary.html) - [TLS Security Migration Guide](/docs/security_migration.html) - [TLS Security Update - Important Information](/docs/tls_security_update.html) - [Transport](/docs/transport.html)