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: 체크포인트 스토어를 통해 에이전트 일시 중지 및 재개 지원.
• Integrated Voice Pipeline: 바지인, 엔드포인트 감지 및 WebRTC를 포함한 실시간 음성 상호작용 지원.