Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Jul 15:26
· 334 commits to main since this release
v0.1.0
32eca32

🎉 The first tagged release of agents-go — build production AI agents in Go.

agents-go is a faithful Go port of the OpenAI Agents SDK (tracking upstream v0.18.2): the same run loop, the same item model, the same defaults — type-safe by construction and idiomatic in Go. It has tracked upstream feature-for-feature, and today it gets its first tag. 🥳

Highlights

Core SDK

  • Agents & a faithful run loop — same semantics as the Python SDK; streaming shares the exact same loop, so behavior is written once.
  • Type-safe tools — a tool is a plain generic Go function; argument schemas and structured outputs are reflected from your structs, not runtime maps.
  • Handoffs — triage and delegate between agents.
  • Guardrails — input, output, and tool-level checks; a tripwire halts the run.
  • Durable human-in-the-loop — pause a run for approval, serialize its state to JSON, and resume later — even in another process.
  • Sessions — in-memory, JSONL file, SQLite/Postgres, or OpenAI server-side history with automatic compaction.
  • Streaming — token and item events as a range-able Go iterator.
  • Production plumbing — retry, fallback, and multi-provider routing as composable model decorators.
  • Tracing — spans for every model call, tool call, handoff, and guardrail.

Batteries included

  • MCP client — stdio and streamable-HTTP tool servers.
  • Code sandboxes — run model-written code in Docker, SSH, or local backends; edit files via apply_patch.
  • Agent Skills — load SKILL.md skills.
  • agents-server — a full web app over the SDK: a versioned REST API, WebSocket streaming, and an embedded browser UI, with tool approval, tracing, and background spawn_task subagents.

Two ways to use it

As a library:

go get github.com/zzir/agents-go

As an app — download a prebuilt agents-server binary for your platform from the Assets below (Linux / macOS / Windows, amd64 / arm64), then run:

./agents-server --port 9527

Verify your download against checksums.txt.

Design notes

  • Responses API only — internal item types are OpenAI Responses types; Chat Completions is intentionally not modeled.
  • Dependency-light core — one small module; Docker/SSH sandboxes, SQL sessions, and Skills are opt-in submodules.
  • Every intentional divergence from the Python SDK is documented.

Get started

Every feature ships with a runnable example:

export OPENAI_API_KEY=sk-...
go run ./examples/hello      # minimal agent
go run ./examples/handoffs   # triage → specialists
go run ./examples/hitl       # pause, approve, resume

Docs: Documentation · Feature reference · Examples

This is the very first release — issues and feedback are hugely welcome. Here's to v0.1.0! 🚀

Assets 9
Loading