GizClaw/flowcraft

Production-grade Go SDK for building AI agents with long-term memory, knowledge retrieval, and voice — runnable as a library, a daemon, or a real-time pipeline.

What it solves

FlowCraft 是一个用于在 Go 中构建 AI 代理的生产级工具包。它通过提供分层架构，将代理逻辑与运行时引擎、内存管理以及供应商集成分离，解决了从简单 LLM 提示到可投入生产系统的复杂性。

How it works

FlowCraft 被组织为多个模块化层级：

  • SDK：提供代理、DAG 执行器与工具管理等核心原语。
  • Memory：使用混合检索系统（BM25 + 向量 + 实体）实现长期回忆，并管理对话历史。
  • SDKX：提供各种 LLM（OpenAI、Anthropic、DeepSeek 等）与嵌入模型的即插即用供应商。
  • Vessel & Vesseld：一个内部运行时（vessel）与一个独立 daemon（vesseld），允许通过声明式 YAML 部署代理，提供生命周期管理与 HTTP/SSE 控制平面。
  • Voice：一条实时管线，将 STT（语音转文字）→ LLM → TTS（文字转语音）串接，内建 VAD（语音活动检测）与 WebRTC 支持。

Who it’s for

此工具包设计给想要在 Go 中构建具备长期记忆与语音功能、且可扩展的生产级 AI 代理的开发者，免除手动拼接各种库或依赖 Python 框架的需求。

Highlights

  • Hybrid Memory：使用 Reciprocal Rank Fusion 结合 BM25、向量与实体检索，以提升回忆准确度。
  • Declarative Deployment：通过 YAML 配置将代理部署为独立 daemon。
  • Provider Portability：只需更改单一 YAML 字段，即可在不同 LLM 供应商间切换。
  • Durable Execution：支持通过 Checkpoint 存储暂停与恢复代理。
  • Integrated Voice Pipeline：内建插话、端点检测与 WebRTC，支持实时语音交互。