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 許可證,歡迎社群貢獻程式碼。