Show HN:PeekAI – Python AI 代理的本地優先可觀測性工具
PeekAI 是一款本地優先的 Python AI 代理可觀測性工具,將所有追蹤數據存儲在本地 SQLite 數據庫中,無需雲賬户或配置。它支持一鍵檢測 OpenAI、Anthropic 和 LiteLLM,提供多代理可視化、追蹤回放功能,並配備命令行界面和 Web 儀表盤。
PeekAI 是一款專為 Python AI 代理設計的本地優先可觀測性工具,旨在解決調試和監控 AI 代理流程中的痛點。與 LangSmith 或 Weights & Biases 等需要將數據發送到雲端並創建賬户的傳統工具不同,PeekAI 將所有追蹤數據存儲在本地 SQLite 數據庫中,確保數據隱私並簡化部署。用户只需通過 pip 安裝 PeekAI,並調用 peekai.init() 即可自動修補 OpenAI、Anthropic 和 LiteLLM 的 SDK,無需修改現有 API 調用。
對於多代理工作流,PeekAI 提供了裝飾器 @peekai.agent、@peekai.tool 和 @peekai.trace,能夠自動構建父/子跨度樹,清晰展示代理間的傳遞。用户可以通過命令行工具查看最近追蹤、統計信息,或使用 peekai map 可視化代理流的 ASCII 樹。此外,PeekAI 還支持追蹤回放功能,允許用户使用不同的模型或修改後的工具響應重新運行歷史追蹤,並將新追蹤與原始追蹤進行對比,直觀顯示代幣和成本差異。
PeekAI 還提供了一個基於 Streamlit 的 Web 儀表盤,包含四個頁面:儀表盤(顯示關鍵性能指標和成本趨勢)、追蹤列表(可篩選)、追蹤視圖(跨度瀑布圖)和回放界面(支持並排比較)。默認的 SQLite 數據庫存儲在 ~/.peekai/peekai.db,用户可以直接用數據庫工具查看或備份。項目目前支持 OpenAI、Anthropic 和 LiteLLM 的同步與異步調用,以及流式傳輸。PeekAI 採用 MIT 許可證,歡迎社區貢獻代碼。