agent-go

AgentGo

Build AI agents in Go. Connect LLMs to tools, chain multiple agents, and deploy as SDK or REST API.

AgentGo lets you create AI agents that call LLM APIs (OpenAI, Anthropic, Gemini, Ollama, etc.), use tools, collaborate in teams, and run structured workflows — all with Go's performance (~180ns agent creation, ~1.2KB memory per agent).

Documentation →

Quick Start

go get github.com/jholhewres/agent-go@latest

SDK Mode

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/jholhewres/agent-go/pkg/agentgo/agent"
    "github.com/jholhewres/agent-go/pkg/agentgo/models/openai"
    "github.com/jholhewres/agent-go/pkg/agentgo/tools/calculator"
    "github.com/jholhewres/agent-go/pkg/agentgo/tools/toolkit"
)

func main() {
    model, _ := openai.New("gpt-4o-mini", openai.Config{
        APIKey: os.Getenv("OPENAI_API_KEY"),
    })

    ag, _ := agent.New(agent.Config{
        Name:     "Assistant",
        Model:    model,
        Toolkits: []toolkit.Toolkit{calculator.New()},
    })

    output, _ := ag.Run(context.Background(), "What is 25 * 4 + 15?")
    fmt.Println(output.Content)
}

AgentOS Mode (REST API)

go run cmd/server/main.go
curl http://localhost:8080/health

See pkg/agentos/README.md for AgentOS documentation.

What It Does

• Agents — Single agents with LLM + tools (calculator, HTTP, file, custom)
• Teams — Multi-agent collaboration (sequential, parallel, leader-follower, consensus)
• Workflows — Step-based orchestration (step, condition, loop, parallel, router)
• Structured Output — RunTyped[T]() returns typed Go structs from LLM responses
• Model Fallback — Chain multiple models with automatic retry and fallback
• Sub-Agents — Spawn child agents or use agents as tools for other agents
• Guardrails & Hooks — Pre/post tool execution hooks, approval gates, input/output validation
• 15+ Providers — OpenAI, Anthropic, Gemini, DeepSeek, GLM, Ollama, Groq, and more
• Session & Memory — Conversation persistence, user learning, history injection

Documentation

Examples

Full examples catalog → cmd/examples/

Development

# Run tests
make test

# Format code
make fmt

# Lint
make lint

See docs/DEVELOPMENT.md for complete guidelines.

License

MIT © Contributors

Maintainer: Jhol Hewres