Go Micro Examples

This directory contains runnable examples demonstrating various go-micro features and patterns.

Quick Start

Each example can be run with go run . from its directory.

Basic RPC service demonstrating core concepts:

Run it:

bash

cd hello-world
go run .

HTTP web service with service discovery:

Run it:

bash

cd web-service
go run .

Multiple services in a single binary — the modular monolith pattern:

Run it:

bash

cd multi-service
go run .

Docker Compose deployment with MCP gateway, Consul registry, and Jaeger tracing:

See the mcp/ directory for AI agent integration examples:

Multi-service project management app (Projects, Tasks, Team) with seed data and agent playground integration.

The two built-in agent capabilities in a small multi-agent system:

plan — an agent records an ordered plan in its store-backed memory before doing multi-step work
delegate — an agent hands a subtask to another agent (over RPC if it's registered, else to an ephemeral sub-agent)

Middleware around an agent's tool execution with AgentWrapTool, the tool-side analogue of client/server wrappers:

observe — time every tool call and record per-tool metrics, correlated by call ID
retry — re-run a call whose result is an error, recovering from a transient failure before the model sees it

A workflow as ordered, checkpointed steps that survives a crash and resumes where it stopped:

steps — a flow is a task with stages (reserve → charge → confirm), not just one LLM turn
Checkpoint — each step is persisted; on Resume, completed steps are not re-run (no duplicate side effects)

Some examples require external dependencies:

NATS: docker run -p 4222:4222 nats:latest
Consul: docker run -p 8500:8500 consul:latest agent -dev -ui -client=0.0.0.0
Redis: docker run -p 6379:6379 redis:latest

To add a new example: