Metadata-Version: 2.5
Name: lookspan-crewai
Version: 0.5.3
Summary: CrewAI observability, local-first: one line of setup traces crew kickoffs, agents, tasks, tools and LLM calls to a Lookspan dashboard on your own machine.
Project-URL: Homepage, https://fervon.dev/lookspan/
Project-URL: Documentation, https://jonimartin27.github.io/lookspan/
Project-URL: Repository, https://github.com/JoniMartin27/lookspan
Project-URL: Issues, https://github.com/JoniMartin27/lookspan/issues
Project-URL: Changelog, https://github.com/JoniMartin27/lookspan/blob/main/CHANGELOG.md
Project-URL: Source, https://github.com/JoniMartin27/lookspan
Author: Jonathan Martin
Maintainer: Jonathan Martin
License: MIT
Keywords: agents,ai,crewai,instrumentation,llm,llmops,local-first,lookspan,monitoring,multi-agent,observability,spans,telemetry,tracing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: crewai>=0.80.0
Requires-Dist: lookspan>=0.5.3
Description-Content-Type: text/markdown

# lookspan-crewai — CrewAI observability, local-first

[![PyPI](https://img.shields.io/pypi/v/lookspan-crewai)](https://pypi.org/project/lookspan-crewai/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/JoniMartin27/lookspan/blob/main/LICENSE)
[![Docs](https://img.shields.io/badge/docs-lookspan-orange)](https://jonimartin27.github.io/lookspan/)

Auto-instruments CrewAI runs and streams every agent step, task, tool call, and
LLM invocation to your local [Lookspan](https://fervon.dev/lookspan/) dashboard —
a process on `127.0.0.1`, not a SaaS. No account, no API key, nothing uploaded.

A crew that "just hangs" or burns tokens somewhere is hard to read from logs. Here
you get the kickoff as a trace, each agent and task as a span, and the tool and LLM
calls nested underneath with their real durations.


## Install

```bash
pip install lookspan-crewai
```

## Quick start

```python
from crewai import Crew
from lookspan import LookspanClient
from lookspan_crewai import attach_lookspan

client = LookspanClient(endpoint="http://127.0.0.1:3100/api/ingest")
attach_lookspan(client, agent_id="research-crew")

crew = Crew(agents=[...], tasks=[...])
result = crew.kickoff()

client.flush()
```

`attach_lookspan` registers listeners on CrewAI's global event bus.

Prompts and completions are **not** recorded unless you pass `capture_content=True`
to `LookspanClient`.

## Links

- Product page — <https://fervon.dev/lookspan/>
- Documentation — <https://jonimartin27.github.io/lookspan/>
- Core SDK — [`lookspan`](https://pypi.org/project/lookspan/) · LangChain/LangGraph — [`lookspan-langgraph`](https://pypi.org/project/lookspan-langgraph/)
- Source and issues — <https://github.com/JoniMartin27/lookspan>

MIT licensed. Part of [Fervon](https://fervon.dev).
