GizClaw/flowcraft

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，支援即時語音互動。