> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai-stats.phaseo.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Run a minimal local agent loop on top of AI Stats Gateway with the Go Agent SDK.

## Install

```bash theme={null}
go get github.com/AI-Stats/AI-Stats/packages/sdk/agent-sdk-go@latest
```

## Quickstart

```go theme={null}
package main

import (
  "context"
  "fmt"

  aistatsagent "github.com/AI-Stats/AI-Stats/packages/sdk/agent-sdk-go"
)

func main() {
  client, err := aistatsagent.CreateGatewayAgentClient(aistatsagent.GatewayAgentClientOptions{})
  if err != nil {
    panic(err)
  }

  agent := aistatsagent.CreateAgent(aistatsagent.AgentDefinition{
    ID:           "quickstart-agent",
    Model:        "openai/gpt-5.4-nano",
    Instructions: "Answer concisely and helpfully.",
  })

  result, err := agent.Run(context.Background(), aistatsagent.RunOptions{
    Input:  "Give me one fun fact about cURL.",
    Client: client,
  })
  if err != nil {
    panic(err)
  }

  fmt.Println(result.Output)
}
```

## What it ships

* `CreateAgent(...)`
* `DefineTool(...)`
* `CreateGatewayAgentClient(...)`
* a bounded tool loop over the AI Stats `responses` API

## Related

* [Agent SDK overview](../agent-sdk/overview.mdx)
* [TypeScript Agent SDK](../typescript/agent-sdk.mdx)