January 10, 2026

Building Your First Multi-Agent System

Tutorial Go

In this tutorial, we’ll build a simple multi-agent system where agents collaborate to process and analyze data. You’ll learn the fundamentals of agent communication, state management, and orchestration with Athyr.

Prerequisites

Before starting, make sure you have:

Project Setup

Create a new directory for your project:

mkdir my-agent-system
cd my-agent-system
go mod init my-agent-system
go get github.com/athyr-tech/athyr-sdk-go

Creating Your First Agent

Let’s start with a simple “echo” agent that receives messages and responds:

package main

import (
    "context"
    "log"

    athyr "github.com/athyr-tech/athyr-sdk-go"
)

func main() {
    agent, err := athyr.NewAgent(athyr.Config{
        Name: "echo-agent",
        Host: "localhost:9090",
    })
    if err != nil {
        log.Fatal(err)
    }

    agent.Handle("echo", func(ctx context.Context, msg athyr.Message) (any, error) {
        return map[string]string{
            "echoed": msg.Payload.(string),
        }, nil
    })

    log.Println("Echo agent starting...")
    agent.Run()
}

Running the System

  1. Start Athyr server:
athyr serve
  1. In another terminal, run your agent:
go run main.go
  1. Test the agent using the Athyr CLI:
athyr call echo-agent echo "Hello, World!"

Adding More Agents

The real power of Athyr comes from multiple agents working together. In the next tutorial, we’ll add:

  • A processor agent that transforms data
  • A storage agent that persists results
  • An orchestrator agent that coordinates the workflow

What’s Next