https://github.com/verikod/hector
A2A-Native AI Agent Platform written in Go
https://github.com/verikod/hector
a2a-protocol ai ai-agent-tools ai-agents ai-agents-framework declarative golang
Last synced: 12 days ago
JSON representation
A2A-Native AI Agent Platform written in Go
- Host: GitHub
- URL: https://github.com/verikod/hector
- Owner: verikod
- License: agpl-3.0
- Created: 2025-09-17T11:03:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-12-24T02:57:17.000Z (18 days ago)
- Last Synced: 2025-12-24T13:36:47.445Z (17 days ago)
- Topics: a2a-protocol, ai, ai-agent-tools, ai-agents, ai-agents-framework, declarative, golang
- Language: Go
- Homepage: https://gohector.dev
- Size: 25.1 MB
- Stars: 46
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
```
██╗ ██╗███████╗ ██████╗████████╗ ██████╗ ██████╗
██║ ██║██╔════╝██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗
███████║█████╗ ██║ ██║ ██║ ██║██████╔╝
██╔══██║██╔══╝ ██║ ██║ ██║ ██║██╔══██╗
██║ ██║███████╗╚██████╗ ██║ ╚██████╔╝██║ ██║
╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝
```
[](https://golang.org/)
[](LICENSE)
[](https://a2a-protocol.org/latest/community/#a2a-integrations)
[](https://gohector.dev)
[](https://goreportcard.com/report/github.com/verikod/hector)
**Config-first A2A-Native Agent Platform**
Deploy observable, secure, and scalable AI agents with unified configuration (YAML), plus a programmatic API.
**[Documentation](https://gohector.dev)** | [Quick Start](https://gohector.dev/getting-started/quick-start/) | [Configuration](https://gohector.dev/guides/configuration/)
---
## Hector Studio (Desktop)
The native desktop GUI for Hector. Manage your agents and workspaces with a rich visual interface.
- **Project**: [verikod/hector-studio](https://github.com/verikod/hector-studio)
- **Download**: [Latest Releases](https://github.com/verikod/hector-studio/releases) (macOS, Windows, Linux)
---
## Quick Start
Hector uses a unified configuration system. You can start with CLI flags (which seed the config) or a config file directly.
### Using CLI Flags
```bash
go install github.com/verikod/hector/cmd/hector@latest
export OPENAI_API_KEY="sk-..."
hector serve --model gpt-4o --tools --studio
```
RAG in one command (with MCP parsing optional):
```bash
hector serve \
--model gpt-4o \
--docs-folder ./documents \
--mcp-url http://localhost:8000/mcp \
--mcp-parser-tool convert_document_into_docling_document
```
### Using Config File
```bash
cat > config.yaml <<'EOF'
version: "2"
llms:
default:
provider: openai
model: gpt-4o
api_key: ${OPENAI_API_KEY}
agents:
assistant:
llm: default
tools: [search]
server:
port: 8080
EOF
hector serve --config config.yaml --studio
```
## Highlights
- **Unified Configuration**: CLI flags seed a YAML config file for repeatability. JSON Schema available via `hector schema`.
- **Programmatic API**: Build agents in Go (`pkg/api.go`), including sub-agents and agent-as-tool patterns.
- **RAG**: Folder-based document stores, embedded vector search (chromem), native PDF/DOCX/XLSX parsers, optional MCP parsing (Docling).
- **Vector DBs**: Embedded chromem (default), or external (Qdrant, Pinecone, Weaviate, Milvus, Chroma).
- **Persistence**: Tasks and sessions can use in-memory or SQL backends (sqlite/postgres/mysql via DSN).
- **Observability**: Metrics endpoint and OTLP tracing options.
- **Checkpointing**: Optional checkpoint/recovery strategies.
- **Auth**: JWT/JWKS (OIDC) support or Shared Secret (Bearer token) at the server layer.
- **Guardrails**: Input validation, prompt injection detection, PII redaction, and tool authorization.
- **A2A-native**: Uses a2a-go types and JSON-RPC/gRPC endpoints.
## Documentation
- [Getting Started](https://gohector.dev/getting-started/quick-start/)
- [Configuration Guide](https://gohector.dev/guides/configuration/)
- [Guardrails Guide](https://gohector.dev/guides/guardrails/)
- [RAG Guide](https://gohector.dev/guides/rag/)
- [Tools Guide](https://gohector.dev/guides/tools/)
- [Core Concepts](https://gohector.dev/concepts/architecture/)
- [Blog & Tutorials](https://gohector.dev/blog/)
## License
AGPL-3.0 (see [LICENSE](LICENSE)).