Installation

Requirements

• Go 1.21+ - agent-go uses modern Go features
• Go modules - the project uses Go modules for dependency management

Install with go get

Add agent-go to your project:

go get github.com/felixgeelhaar/agent-go

Import the API

The public API is exposed through the interfaces/api package:

import api "github.com/felixgeelhaar/agent-go/interfaces/api"

This package re-exports all commonly used types and functions, so you typically only need this single import.

Verify Installation

Create a simple test file to verify everything works:

package main

import (
    "fmt"
    api "github.com/felixgeelhaar/agent-go/interfaces/api"
)

func main() {
    // Create a tool registry
    registry := api.NewToolRegistry()
    fmt.Printf("agent-go installed successfully! Registry: %T\n", registry)
}

Run with:

go run main.go

Dependencies

agent-go uses these external libraries:

• statekit - Statechart execution engine with hierarchical states, guards, and actions
• fortify - Resilience patterns (circuit breaker, retry, rate limiter, bulkhead)
• bolt - High-performance zero-allocation structured logging

These are automatically installed when you go get agent-go.