██╗  ██╗███████╗ ██████╗████████╗ ██████╗ ██████╗ 
██║  ██║██╔════╝██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗
███████║█████╗  ██║        ██║   ██║   ██║██████╔╝
██╔══██║██╔══╝  ██║        ██║   ██║   ██║██╔══██╗
██║  ██║███████╗╚██████╗   ██║   ╚██████╔╝██║  ██║
╚═╝  ╚═╝╚══════╝ ╚═════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝

⚠️ Alpha Version: This project is in active development. Features may change as we refine the platform.

# Install (single binary, no dependencies)
go install github.com/kadirpekel/hector/cmd/hector@latest

# Set API key
export OPENAI_API_KEY="sk-..."

# Run your first agent (zero-config mode)
hector call "What is the capital of France?"

Why Go? Unlike Python-based frameworks, Hector compiles to a single binary with no runtime dependencies. Deploy anywhere—from edge devices to Kubernetes—with consistent performance and minimal resource usage.

agents:
  assistant:
    llm: gpt-4o
    tools: [search, write_file, execute_command]
    reasoning:
      engine: chain-of-thought
      max_iterations: 100
    memory:
      working:
        strategy: summary_buffer

That's it. No code required.

• Zero-code development - YAML configuration only
• Instant setup - Working agent in 5 minutes
• Advanced memory - Working & long-term memory strategies
• RAG & semantic search - Built-in vector store integration
• Rich tool ecosystem - Built-in tools, MCP, and plugins

• True interoperability - Native A2A protocol support
• Multi-agent orchestration - Coordinate specialized agents
• Production security - JWT auth, API keys, agent-level security
• Distributed architecture - Local, server, or client modes
• Multi-transport APIs - REST, SSE, WebSocket, gRPC

• Simple configuration - Human-readable YAML
• Declarative approach - No code to maintain
• Built with Go - Production performance, single binary, no dependencies
• Flexible deployment - Docker, Kubernetes, systemd
• Extensible platform - Custom plugins via gRPC
• Open source - AGPL-3.0 licensed

📚 Complete Documentation at gohector.dev

• Getting Started - Install and run in 5 minutes
• Core Concepts - Understanding agents, LLMs, memory, tools
• How-To Guides - Build real-world agents
• CLI Reference - Command-line interface
• Configuration - Complete YAML reference
• API Reference - REST, gRPC, WebSocket APIs
• A2A Protocol - Protocol compliance

Hector's layered architecture:

Application (Your Agents)
         ↓
   Hector Runtime
         ↓
    A2A Protocol
         ↓
Multi-Transport Layer (gRPC, REST, JSON-RPC)
         ↓
  Agent Orchestration
         ↓
Core Services (LLM, Memory, Tools, RAG, Tasks)

For detailed architecture, see the Architecture Reference.

Three ways to run Hector:

# 1. Local Mode - In-process execution
hector call assistant "Hello"

# 2. Server Mode - Host agents for multiple clients
hector serve --config agents.yaml

# 3. Client Mode - Connect to remote agents
hector call assistant "Hello" --server https://remote:8080

Coordinate specialized agents:

agents:
  coordinator:
    llm: gpt-4o
    reasoning:
      engine: supervisor
    tools:
      - agent_call
    sub_agents:
      - researcher
      - analyst
      - writer
  
  researcher:
    llm: gpt-4o
    tools: [search]
  
  analyst:
    llm: claude-sonnet-4
    tools: [search]
  
  writer:
    llm: gpt-4o
    tools: [write_file]

See Multi-Agent Tutorial for complete example.

Hector is 100% compliant with the Agent-to-Agent protocol, enabling true interoperability:

• Connect to any A2A-compliant agent
• Expose your agents for others to use
• Federation across organizations
• Standards-based communication

Learn more: A2A Protocol Reference

Check out configs/ for complete examples:

• Coding Assistant - AI pair programmer
• Multi-Agent Research - Coordinated research system
• MCP Tools Integration - External tool integration
• Memory Strategies - Memory management
• Security Setup - JWT authentication

We welcome contributions! Hector is in active development and we're building this in the open.

Ways to contribute:

• 🐛 Report bugs and issues
• 💡 Suggest features and improvements
• 📖 Improve documentation
• 🔧 Submit pull requests
• ⭐ Star the repo and spread the word

See Contributing Guidelines for details.

• Documentation: gohector.dev
• Issues: GitHub Issues
• Discussions: GitHub Discussions

AGPL-3.0 - See LICENSE.md for details.

Hector is free and open-source software. You can use, modify, and distribute it under the terms of the AGPL-3.0 license.

For commercial licensing options, please contact the maintainers.