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）とスタンドアロンデーモン（`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 設定でエージェントをスタンドアロンデーモンとしてデプロイ。
• Provider Portability：YAML のフィールドを一つ変更するだけで、異なる LLM プロバイダー間を切り替え可能。
• Durable Execution：Checkpoint ストアを介してエージェントの一時停止と再開をサポート。
• Integrated Voice Pipeline：バージイン、エンドポイント検出、WebRTC を組み込んだリアルタイム音声インタラクションを提供。