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

pip install beacon-trace

Usage

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:

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:

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

Then open http://localhost:3000.

Metadata

Release files for beacon-trace 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for beacon-trace 1.0.2
File	Size	Uploaded
beacon_trace-1.0.2.tar.gz	3.7 kB	May 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for beacon-trace 1.0.2
File	Interpreter	ABI	Platform	Reset
beacon_trace-1.0.2-py3-none-any.whl 4.0 kB May 30, 2026	Python 3	none	any	Details

Total release size: 7.7 kB

Release files / beacon_trace-1.0.2.tar.gz

Download URL	beacon_trace-1.0.2.tar.gz
Size	3.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`fc996e2185b27d7068f3da449aa04d4e564d94d2d862de976e2bfe5633f2050a`
BLAKE2b-256 checksum How to use checksums	`2ad4c0bde369396b5c56f0e04fd9de67957aadf5f7529174dfb8abb4def1978f`
Upload date	May 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.12`

Release files / beacon_trace-1.0.2-py3-none-any.whl

Download URL	beacon_trace-1.0.2-py3-none-any.whl
Size	4.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8c83071c0825f97cd360b897d5fc1877914829fce5161d7ed6f129121c4caf50`
BLAKE2b-256 checksum How to use checksums	`08d818ff1dc10af498bc3129e18d42b43477c5941b40d24596803765414c50c7`
Upload date	May 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.12`