README
obsalt [Legacy]
A far more capable obsalt with call simulations, production monitoring and many more is being built. This project is superseded by it and will not be continued further.
Self-hosted call analytics and quality for live AI voice agents.
You already have a voice stack — Vapi, Retell, Pipecat, LiveKit, or something that talks to customers. obsalt is the service you run next to it. Live calls flow in. The console joins the transcript, the timing, the hangup, the tools, and quality checks on one page you own.
| Piece | What you get |
|---|---|
| Service | HTTP API + worker. Receives calls, stores them, scores them. |
| Console | Seven screens at /v1/ui. The call-detail join view is the product. |
VoiceCall | A thin tracer. Import it only if you own the agent process. |
Core ships no providers. Install obsalt-vapi, obsalt-pipecat,
or another source plugin. Memory stores are test doubles, not a
backend. There is no SQLite mode.
Start at What obsalt does.
How a call gets in
flowchart LR
hosted[Hosted platform] -->|signed webhook| ingest[obsalt]
custom[Your agent] -->|OTLP traces| ingest
ingest --> console[Console /v1/ui]
ingest --> tempo[Your Tempo optional]
ingest --> api[HTTP API /v1]
Pick one path per call. Mixing a webhook and OTLP on the same conversation gives you two partial records that do not join.
A timeline bar is drawn only when the source sent real start and end timestamps. Hosted platforms often send durations without clocks. Those become chips, not invented waterfalls.
Under the hood: Postgres (inbox, keys, which revision is live),
ClickHouse (immutable call facts), object storage (raw payloads,
short-lived), Redis (optional lease accelerator).
docker compose up is the supported path.
What it answers
| Capability | Question |
|---|---|
| Latency | Where did time go? |
| Hangups | Why did we lose this caller? |
| Hallucination | Did the agent invent a price, an id, or a completed tool? |
| Tools | Which function calls fail, retry, or stall the turn? |
| Evals | Did this call meet our bar, in plain English? |
| Search | Show me calls where customers asked about refunds. |
What you see on Vapi is not what you see on Pipecat. Read your row in the console before you file a bug.
Two ways in
| You already run | How it connects | Guide |
|---|---|---|
| Vapi, Retell, ElevenLabs, Cartesia | They POST a signed webhook | Connect a hosted platform |
| Pipecat, LiveKit, OpenAI Realtime, Gemini Live | Your process emits OTLP | Connect your own agent |
Run it
git clone https://github.com/coder-with-a-bushido/obsalt.git && cd obsalt && docker compose up -d
That is Postgres, ClickHouse, Redis, MinIO, the API + console on
:8080, and the decode worker. An empty call list is success. Open
http://localhost:8080/v1/ui and sign in with dev-key. Change
OBSALT_BOOTSTRAP_API_KEY in .env before anything is reachable from
a network you do not trust.
Developers who want the console populated locally: obsalt seed
(see Develop). Host processes instead of containers:
Start.
Documentation
| I want to… | Go here |
|---|---|
| See what the product does | What obsalt does |
| Run it on my machine | Start |
| Point Vapi / Retell / ElevenLabs / Cartesia at it | Connect a hosted platform |
| Point my Pipecat / LiveKit / Realtime / Gemini agent at it | Connect your own agent |
| Know what I will see, provider by provider | The console |
| Fix an empty list, a 401, or a missing waterfall | Operate |
| Call the HTTP API | HTTP API |
| Change this repo | Develop · Conventions |
Full index: docs/README.md.
Repository
packages/obsalt service: domain, ingest, assembly, analysis, API, UI
packages/obsalt-testkit conformance tests for plugin authors
packages/obsalt-* first-party source plugins (not bundled into core)
tests/ unit / integration / blackbox / contract / conformance
docs/ start here after this README
make install
make test-unit # fast path
make ci # lint + typecheck + full tests
This product is unreleased. Packaging versions exist so extras resolve; they are not a public release number.
License: Apache-2.0
Contributors
Similar repos
Languages
Python
94.6%
HTML
5.3%
README
obsalt [Legacy]
A far more capable obsalt with call simulations, production monitoring and many more is being built. This project is superseded by it and will not be continued further.
Self-hosted call analytics and quality for live AI voice agents.
You already have a voice stack — Vapi, Retell, Pipecat, LiveKit, or something that talks to customers. obsalt is the service you run next to it. Live calls flow in. The console joins the transcript, the timing, the hangup, the tools, and quality checks on one page you own.
| Piece | What you get |
|---|---|
| Service | HTTP API + worker. Receives calls, stores them, scores them. |
| Console | Seven screens at /v1/ui. The call-detail join view is the product. |
VoiceCall | A thin tracer. Import it only if you own the agent process. |
Core ships no providers. Install obsalt-vapi, obsalt-pipecat,
or another source plugin. Memory stores are test doubles, not a
backend. There is no SQLite mode.
Start at What obsalt does.
How a call gets in
flowchart LR
hosted[Hosted platform] -->|signed webhook| ingest[obsalt]
custom[Your agent] -->|OTLP traces| ingest
ingest --> console[Console /v1/ui]
ingest --> tempo[Your Tempo optional]
ingest --> api[HTTP API /v1]
Pick one path per call. Mixing a webhook and OTLP on the same conversation gives you two partial records that do not join.
A timeline bar is drawn only when the source sent real start and end timestamps. Hosted platforms often send durations without clocks. Those become chips, not invented waterfalls.
Under the hood: Postgres (inbox, keys, which revision is live),
ClickHouse (immutable call facts), object storage (raw payloads,
short-lived), Redis (optional lease accelerator).
docker compose up is the supported path.
What it answers
| Capability | Question |
|---|---|
| Latency | Where did time go? |
| Hangups | Why did we lose this caller? |
| Hallucination | Did the agent invent a price, an id, or a completed tool? |
| Tools | Which function calls fail, retry, or stall the turn? |
| Evals | Did this call meet our bar, in plain English? |
| Search | Show me calls where customers asked about refunds. |
What you see on Vapi is not what you see on Pipecat. Read your row in the console before you file a bug.
Two ways in
| You already run | How it connects | Guide |
|---|---|---|
| Vapi, Retell, ElevenLabs, Cartesia | They POST a signed webhook | Connect a hosted platform |
| Pipecat, LiveKit, OpenAI Realtime, Gemini Live | Your process emits OTLP | Connect your own agent |
Run it
git clone https://github.com/coder-with-a-bushido/obsalt.git && cd obsalt && docker compose up -d
That is Postgres, ClickHouse, Redis, MinIO, the API + console on
:8080, and the decode worker. An empty call list is success. Open
http://localhost:8080/v1/ui and sign in with dev-key. Change
OBSALT_BOOTSTRAP_API_KEY in .env before anything is reachable from
a network you do not trust.
Developers who want the console populated locally: obsalt seed
(see Develop). Host processes instead of containers:
Start.
Documentation
| I want to… | Go here |
|---|---|
| See what the product does | What obsalt does |
| Run it on my machine | Start |
| Point Vapi / Retell / ElevenLabs / Cartesia at it | Connect a hosted platform |
| Point my Pipecat / LiveKit / Realtime / Gemini agent at it | Connect your own agent |
| Know what I will see, provider by provider | The console |
| Fix an empty list, a 401, or a missing waterfall | Operate |
| Call the HTTP API | HTTP API |
| Change this repo | Develop · Conventions |
Full index: docs/README.md.
Repository
packages/obsalt service: domain, ingest, assembly, analysis, API, UI
packages/obsalt-testkit conformance tests for plugin authors
packages/obsalt-* first-party source plugins (not bundled into core)
tests/ unit / integration / blackbox / contract / conformance
docs/ start here after this README
make install
make test-unit # fast path
make ci # lint + typecheck + full tests
This product is unreleased. Packaging versions exist so extras resolve; they are not a public release number.
License: Apache-2.0
Similar repos
Contributors
Languages
Python
94.6%
HTML
5.3%