Learn by Example

Learn by building real microservices with go-micro

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.