README

!Static Badge
!X (formerly Twitter) Follow
!LinkedIn
 !Static Badge 

!Laminar banner

 Laminar

Laminar is an open-source observability platform purpose-built for AI agents.

- [x] Tracing. Docs
    - [x] OpenTelemetry-native powerful tracing SDK - 1 line of code to automatically trace Vercel AI SDK, Browser Use, Stagehand, LangChain, OpenAI, Anthropic, Gemini, and more.
- [x] Signals. Docs
    - [x] Describe any behavior of your agent that you want to track in plain English (e.g. "agent is stuck in a loop")
    - [x] Laminar reads every agent run and pings you in Slack when it happens.
- [x] Evals. Docs
    - [x] Unopinionated, extensible SDK and CLI for running evals locally or in CI/CD pipeline.
    - [x] UI for visualizing evals and comparing results.
- [x] MCP / CLI access for your coding agent 
    - [x] Query traces, spans, metrics, and events with SQL
    - [x] Let your coding agent investigate and debug issues based on your traces
- [x] Dashboards. Docs
    - [x] Powerful dashboard builder for traces, metrics, and events with support of custom SQL queries.
- [x] Data annotation & Datasets. Docs
    - [x] Custom data rendering UI for fast data annotation and dataset creation for evals.
- [x] Extremely high performance.
    - [x] Written in Rust 🦀
    - [x] 20x trace compression for efficient ingestion and storage. Read more about it here.
    - [x] Custom realtime engine for viewing traces as they happen.
    - [x] Ultra-fast full-text search over span data.
    - [x] gRPC exporter for tracing data.

!Traces

 Documentation

Check out the full documentation here laminar.sh/docs.

 Getting started

The fastest and easiest way to get started is with our managed platform - laminar.sh

 Self-hosting with Docker compose

Laminar is very easy to self-host locally. For a quick start, clone the repo and start the services with docker compose:
sh
git clone https://github.com/lmnr-ai/lmnr
cd lmnr
docker compose up -d


This will spin up a lightweight but full-featured version of the stack. This is good for a quickstart 
or for lightweight usage. You can access the UI at http://localhost:5667 in your browser.

You will also need to properly configure the SDK, with baseUrl and correct ports. See guide on self-hosting.

For production environment, we recommend using our managed platform or docker compose -f docker-compose-full.yml up -d.

 Upgrading existing self-hosted installations

The ClickHouse configuration disables internal telemetry logs that are not useful
for a single-node installation and retains query and error logs for three days.
After pulling this change, recreate the ClickHouse container to apply the
configuration. The examples below use docker-compose.yml; pass -f with the
Compose file used by your deployment when it differs:

sh
docker compose up -d --force-recreate clickhouse


Disabling a system log stops new writes but does not clear an existing table.
To reclaim its disk space while preserving the table structure, truncate the
d