Metadata-Version: 2.4
Name: beacon-trace
Version: 1.0.0
Summary: Local-first observability SDK for AI agents
Home-page: https://github.com/yourusername/beacon
Author: Beacon Team
Author-email: Beacon Team - Vikas Budde <vikas.budde@hotmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/pisigmac/beacon
Project-URL: Repository, https://github.com/pisigmac/beacon
Project-URL: Issues, https://github.com/pisigmac/beacon/issues
Keywords: ai,agents,observability,tracing,llm,monitoring
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# beacon-agent

Local-first observability SDK for AI agents.

Instrument your agent with one decorator and get a live dashboard with traces, costs, and alerts — all running locally.

## Install

```bash
pip install beacon-trace
```

## Usage

```python
from beacon import trace

@trace(agent_id="my-agent", api_url="http://localhost:8000")
def run_agent(prompt: str) -> str:
    # your agent logic
    return result
```

Full control:

```python
from beacon import BeaconTracer

tracer = BeaconTracer(agent_id="my-agent", api_url="http://localhost:8000")
tracer.start_trace(metadata={"user_id": "123"})

tracer.log_step(
    step_type="llm_call",
    model="gpt-4",
    input_tokens=1200,
    output_tokens=400,
    cost_usd=0.012,
    latency_ms=1200
)

tracer.end_trace(status="success")
```

## Dashboard

Start the Beacon server to see your traces:

```bash
curl -fsSL https://raw.githubusercontent.com/pisigmac/beacon/main/install.sh | bash
beacon start
```

Then open [http://localhost:3000](http://localhost:3000).

## Links

- [GitHub](https://github.com/pisigmac/beacon)
- [Issues](https://github.com/pisigmac/beacon/issues)
