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 许可证,欢迎社区贡献代码。