Examples

Learn by building real microservices with go-micro

Learn by Example

Runnable examples are the fastest way to move from reading the guides to changing one thing. Start with the path that matches where you are in the services → agents → workflows lifecycle.

Start here

For the provider-free first-agent route, run examples/first-agent, then follow No-secret First Agent, Your First Agent, Debugging your agent, and the 0→hero Reference.

Goal	Runnable example	Why it is useful
0→1 service	`examples/hello-world`	Smallest RPC service with a client call and health checks.
Provider-free first agent	`examples/first-agent`	Smallest service-backed agent with a deterministic mock model; no provider key required.
First service-backed agent	`examples/agent-demo`	Multi-service project/task/team app with agent playground integration.
0→hero lifecycle	`examples/support`	No-secret support-desk story: typed services, an agent, an event-driven flow, and a guardrail.
Planning and delegation	`examples/agent-plan-delegate`	Two agents collaborate through `plan` and `delegate` over normal Go Micro RPC.
Durable agent runs	`examples/agent-durable`	Checkpoint and resume a model-directed run without replaying completed tool side effects.
Durable workflows	`examples/flow-durable`	Ordered, checkpointed flow steps resume without duplicating completed side effects.
AI-callable services	`examples/mcp`	MCP examples that expose service endpoints as model tools.

Guide-to-example map

Getting Started → run examples/support to see the full lifecycle before generating your own service.
No-secret First Agent → run examples/first-agent first for the smallest provider-free agent transcript.
Your First Agent → run examples/agent-demo or examples/support when you want a complete service-backed agent to inspect.
Debugging your agent → keep examples/first-agent nearby as the smallest mock-model reproduction before inspecting richer runs.
0→hero Reference → run examples/support for the human-readable scenario, then make harness for the full CI contract.
Plan & Delegate → run examples/agent-plan-delegate.
Agents and Workflows → run examples/flow-durable for deterministic checkpointed steps, examples/agent-durable for model-directed checkpointed runs, and examples/support for the full services → agents → workflows lifecycle.