Ingenimax/agent-sdk-go
A powerful Go framework for building production-ready AI agents!
Ingenimax / agent‑sdk‑go – Go SDK for building AI agents
What it is
- A Go library (and accompanying CLI) that lets you assemble production‑grade AI agents. It wraps large‑language‑model (LLM) providers (OpenAI, Anthropic, Google Vertex AI) and adds a toolbox of features that are common in enterprise‑level agents: persistent memory, tool calling, multi‑agent orchestration, guardrails, observability, and multi‑tenant isolation.
Key capabilities
| Area | What the SDK provides |
|---|---|
| LLM integration | Plug‑and‑play clients for OpenAI, Anthropic, Gemini; token‑usage reporting; model‑context‑protocol (MCP) support over HTTP/SSE or stdio. |
| Memory | Conversation buffer, vector‑based retrieval, summarisation, consolidation of facts, and durable storage back‑ends (in‑memory, SQLite, Postgres, Redis). |
| Tools | Built‑in web‑search tool, calculator, and a registry for custom tools. Tools are invoked automatically by the agent when needed. |
| Agent orchestration | Define agents in YAML, compose them in sequential, parallel, loop or graph patterns, and let a model transfer a conversation to a more suitable sub‑agent. |
| Enterprise features | Guardrails for safety, tracing/logging, multi‑tenant isolation, hook/plugin system to audit or rewrite tool calls, background run management, and token‑cost tracking. |
| Developer experience | Declarative YAML configuration, auto‑generated agent setups from system prompts, structured‑task framework, versioned evaluation datasets with JSON/JUnit reports. |
How you use it
- Add the library –
go get github.com/Ingenimax/agent-sdk-go. - Create an LLM client (e.g.,
openai.NewClient(apiKey)). - Register tools via
tools.NewRegistry()and optionally add the built‑in web‑search tool. - Instantiate an agent with
agent.NewAgent, passing the LLM, memory, tools, system prompt, etc. - Run the agent – call
agent.Run(ctx, "your query")or start an interactive chat with the providedagent-cli.
Configuration
- Environment variables (e.g.,
OPENAI_API_KEY,REDIS_ADDRESS) drive the SDK. - Full YAML schemas let you describe agents, tasks, memory back‑ends, MCP servers, and even response JSON schemas.
- Example YAML shows hierarchical agents, sub‑agents, and runtime settings.
CLI
agent-cli initcreates a starter config.agent-cli run "question"executes a single query.agent-cli chatopens an interactive REPL.- The CLI can be installed from pre‑built binaries,
go install, or built locally withmake build-cli.
Ecosystem
- Documentation site: https://docs.goagents.dev/
- An AI assistant named Nina can be connected via MCP for in‑IDE help (Cursor, Claude Desktop).
- The project supports optional Redis for distributed memory and offers hooks for custom auditing.
Who it’s for
- Go developers who need a ready‑made framework to build chat‑based assistants, research bots, or any workflow that combines LLM reasoning with external tools.
- Teams looking for enterprise‑grade features (multi‑tenant, guardrails, observability) without wiring everything from scratch.
Bottom line Ingenimax’s agent‑sdk‑go is a comprehensive, production‑focused Go toolkit for constructing, configuring, and running AI agents that can call tools, remember context, and operate safely at scale.
Related
- Project
- Dispatch
- Project
- Project
- Project