Older documentation. Start with the current guides.
Getting Started
Go Micro connects services through discovery, RPC, and publish/subscribe. Agents use service endpoints as tools. Workflows coordinate defined sequences of work. You can use these parts independently and extend them through Go interfaces.
Build your first project
Follow Build your first project for the complete path:
install the CLI, open chat, build a service, call it, change it, and run it after
chat exits. The walkthrough lists the required tools and what to check at each
step. The interactive development experience currently requires master.
Keep developing locally
From a project directory, micro run discovers services, builds them, and starts
a local gateway and development console. It watches for source changes and
rebuilds affected services:
micro run
Stop any copies you launched yourself before starting the same services here. Run with the provider configuration required by your agents. CLI chat settings are project-specific and are not automatically the configuration of your Go programs. See the CLI reference for runtime flags and provider environment variables.
Define the application in Go
The CLI is one way to use the framework. Its services, models, tools, and agent loop are also available to your own Go programs.
- Build a service: implement typed handlers and call them over RPC.
- Build an agent: give it instructions and services to use as tools.
- Compose a workflow: combine service calls and agent decisions into defined steps.
- Choose infrastructure: understand the registry, transport, broker, store, and other replaceable components.
- Deploy: run your application beyond local development.
Use a matching framework version when building hosts for the development CLI:
go get go-micro.dev/v6@master
For a provider-free service-and-agent example, run
examples/first-agent.