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.