1
Install the SDK
Add the instrumentation layer to your Python project.
2
Start the Daemon
Start the high-performance Go daemon that ingests trace data.
3
Instrument & Trace
Wrap your agent code in traces and spans — that's it.
Script Install
One-liner install for Linux & macOS. Downloads the latest binary and places it in your PATH.
curl -fsSL https://raw.githubusercontent.com/Mr-Dark-debug/Oculo/main/install.sh | bash
Python SDK (pip)
Install the Python instrumentation library directly from PyPI.
pip install oculo
Docker
Run the daemon in an isolated container. Ideal for CI/CD or team environments.
docker run -d -p 7600:7600 \ oculo/daemon:latest
Build from Source
Clone and build the daemon yourself using Go 1.22+.
git clone https://github.com/Mr-Dark-debug/Oculo.git cd Oculo && go build -o oculo ./cmd/oculo
Ready to instrument your first agent?
Read the Docs →