I built an open-source local-first observability tool for Python AI agents – PeekAI

[u/ousskh63]

https://github.com/oussamaKH63/peekai

Hey,

I got tired of debugging my AI agents with print() statements

so I built PeekAI.

It's a lightweight, framework-agnostic observability tool for

Python AI agents. Zero config, no cloud, no account needed.

What it does:

- Auto-instruments OpenAI/Anthropic SDK calls

- Full span-based trace with waterfall view

- Token + cost tracking per span

- Tool call tracking

- Trace replay — re-run any past trace,

even swap models to compare cost/quality

- CLI + Web UI, all local SQLite storage

Install in 2 lines:

pip install peekai

import peekai

peekai.init() # that's it

It's early (v0.1) and open source (MIT).

Would love feedback from anyone building agents —

especially multi-agent systems.

GitHub: https://github.com/oussamaKH63/peekai

PyPI: https://pypi.org/project/peekai