Metadata-Version: 2.4
Name: veilpiercer
Version: 0.2.0
Summary: Local-first AI agent observability for Ollama, LangChain, LangGraph & CrewAI
Author-email: VeilPiercer <support@veil-piercer.com>
License: MIT
Project-URL: Homepage, https://veil-piercer.com
Project-URL: Documentation, https://veil-piercer.com/docs
Keywords: llm,observability,ollama,langchain,agent-debugging,local-first
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Provides-Extra: hosted
Requires-Dist: websockets>=12.0; extra == "hosted"

# VeilPiercer

**LangSmith for your laptop.** Local-first AI agent observability — per-step tracing, divergence detection, zero cloud.

```bash
pip install veilpiercer
```

## Quick Start

### LangChain (2 lines)
```python
from veilpiercer import VeilPiercerCallback
chain = LLMChain(llm=ollama, callbacks=[VeilPiercerCallback()])
```

### Ollama direct (1 line)
```python
import veilpiercer.ollama_hook  # all ollama.chat() calls now traced
```

### Any framework (manual)
```python
from veilpiercer import SessionLogger
with SessionLogger.new("my-agent") as sess:
    sess.log_step(prompt=p, response=r, state_version="v1")
```

## Why VeilPiercer

- ✅ **100% local** — nothing leaves your machine
- ✅ **Zero setup** — no Docker, no OpenTelemetry, no cloud account
- ✅ **LangChain + Ollama + CrewAI + LangGraph + LlamaIndex**
- ✅ **Visual diff UI** — see exactly where two agent runs diverged
- ✅ **Hallucination flags** — automatic anomaly detection per step

## Compare two runs

```bash
veilpiercer diff session-A session-B
```

Or open `vp_session_diff.html` in your browser.

## Learn more

[veil-piercer.com](https://veil-piercer.com)
