Production-ready Go framework for building intelligent multi-agent AI systems
AgenticGoKit enables developers to build sophisticated agent workflows with dynamic tool integration, multi-provider LLM support, and enterprise-grade orchestration patterns. Designed for Go developers who need the performance and reliability of compiled binaries with the flexibility of modern AI agent systems.
⚠️ Alpha Release: AgenticGoKit is currently in alpha development. APIs may change, and some features are still being developed. Suitable for experimentation and early adoption, but not recommended for production use yet.
Create a collaborative multi-agent system with one command:
# Install the CLI
go install github.com/kunalkushwaha/agenticgokit/cmd/agentcli@latest
# Create a multi-agent research team
agentcli create research-team --template research-assistant --visualize
cd research-team
# Set your API key
export AZURE_OPENAI_API_KEY=your-key-here
export AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
export AZURE_OPENAI_DEPLOYMENT=your-deployment-name
# Run the collaborative system
go run . -m "Research the latest developments in AI agent frameworks"What you get:
- Complete Go project with
main.go,agentflow.toml, andgo.mod - Three specialized agents working in parallel
- Automatic result synthesis and error handling
- Mermaid workflow diagrams generated
- Production-ready project structure
That's it! Multi-agent collaboration with one CLI command.
iwr -useb https://raw.githubusercontent.com/kunalkushwaha/agenticgokit/master/install.ps1 | iexcurl -fsSL https://raw.githubusercontent.com/kunalkushwaha/agenticgokit/master/install.sh | bashgo install github.com/kunalkushwaha/agenticgokit/cmd/agentcli@latest# Linux/macOS
curl -fsSL https://raw.githubusercontent.com/kunalkushwaha/agenticgokit/master/install.sh | bash -s -- --version v0.3.0
# Windows
iwr -useb 'https://raw.githubusercontent.com/kunalkushwaha/agenticgokit/master/install.ps1' | iex -Version v0.3.0- Go to Releases
- Download binary for your platform
- Add to PATH
git clone https://github.com/kunalkushwaha/agenticgokit.git
cd agenticgokit
make build# Verify installation
agentcli version
# Enable shell completion (optional)
# Bash: source <(agentcli completion bash)
# Zsh: agentcli completion zsh > "${fpath[1]}/_agentcli"
# PowerShell: agentcli completion powershell | Out-String | Invoke-Expression
# Create your first project
agentcli create my-project --template basicComplete Installation Guide - Detailed instructions, troubleshooting, and advanced options
| For Developers | For AI Systems |
|---|---|
| Go-Native Performance: Compiled binaries, efficient memory usage | Multi-Agent Focus: Built specifically for agent orchestration |
| Type Safety: Compile-time error checking prevents runtime issues | Memory & RAG: Built-in vector databases and knowledge management |
| Simple Deployment: Single binary, no complex Python environments | Tool Integration: MCP protocol for dynamic tool discovery |
| Native Concurrency: Goroutines for true parallel agent execution | Production Ready: Error handling, monitoring, scaling patterns |
Framework Comparison: See our detailed comparison with LangChain, AutoGen, CrewAI, and Semantic Kernel.
|
Multi-agent research teams with web search, analysis, and synthesis agentcli create research-team \
--template research-assistant \
--visualizeSequential workflows with error handling and monitoring agentcli create data-pipeline \
--template data-pipeline \
--visualize |
Chat agents with persistent memory and context agentcli create chat-system \
--template chat-system \
--visualizeRAG-powered Q&A with document ingestion and vector search agentcli create knowledge-base \
--template rag-system \
--visualize |
|
Get your first agent running immediately go get github.com/kunalkushwaha/agenticgokit |
Follow guided tutorials to master concepts |
Run working examples and demos git clone https://github.com/kunalkushwaha/agenticgokit
cd examples/04-rag-knowledge-base
docker-compose up -d
go run main.go |
// Collaborative agents (parallel execution)
agents := map[string]core.AgentHandler{
"researcher": NewResearchAgent(),
"analyzer": NewAnalysisAgent(),
"validator": NewValidationAgent(),
}
runner := core.CreateCollaborativeRunner(agents, 30*time.Second)
result, err := runner.ProcessEvent(ctx, event)# agentflow.toml
[orchestration]
mode = "collaborative"
timeout_seconds = 30
[agent_memory]
provider = "pgvector"
enable_rag = true
chunk_size = 1000
[mcp]
enabled = true// Configure persistent memory with vector search
memory, err := core.NewMemory(core.AgentMemoryConfig{
Provider: "pgvector",
EnableRAG: true,
EnableKnowledgeBase: true,
ChunkSize: 1000,
})// MCP tools are automatically discovered and integrated
// Agents can use web search, file operations, and custom tools
agent := agents.NewToolEnabledAgent("assistant", llmProvider, toolManager)- Multi-Agent Orchestration: Collaborative, sequential, loop, and mixed patterns
- Memory & RAG: PostgreSQL pgvector, Weaviate, and in-memory providers
- Tool Integration: MCP protocol support for dynamic tool discovery
- Configuration Management: TOML-based configuration with environment overrides
- Workflow Visualization: Automatic Mermaid diagram generation
- CLI Scaffolding: Generate complete projects with one command
- Production Patterns: Error handling, retry logic, and monitoring hooks
|
|
|
|
# For Azure OpenAI (recommended)
export AZURE_OPENAI_API_KEY=your-key-here
export AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
export AZURE_OPENAI_DEPLOYMENT=your-deployment-name
# For OpenAI
export OPENAI_API_KEY=your-key-here
# For Ollama (local)
export OLLAMA_HOST=http://localhost:11434AgenticGoKit uses public plugin packages that self-register via blank imports. Ensure your main package (or your CLI/plugins bundle) includes the imports for the features you use:
import (
_ "github.com/kunalkushwaha/agenticgokit/plugins/llm/ollama"
_ "github.com/kunalkushwaha/agenticgokit/plugins/logging/zerolog"
_ "github.com/kunalkushwaha/agenticgokit/plugins/orchestrator/default"
_ "github.com/kunalkushwaha/agenticgokit/plugins/runner/default"
)Troubleshooting: If you see errors like "provider not registered" or "orchestrator factory not registered", add the corresponding blank import above. The scaffolded projects and agentcli already include a plugins bundle by default.
|
|
|
Apache 2.0 - see LICENSE for details.
AgenticGoKit: Where Go performance meets AI agent intelligence.
![@github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=64&v=4){kind=small}