# Unimeter

> Open source usage metering engine. Record events, aggregate in real time, query billing totals in microseconds.

Unimeter is an alternative to Lago, Amberflo, and similar usage-based billing platforms. It is a single compiled binary with zero runtime dependencies. Measured on a 3-node bare-metal cluster: 4.01M events/sec async, 1.70M events/sec durable (fsync + quorum-replicated), 171µs p50 / 224µs p99 durable write latency. Events go in, usage totals come out.

## Docs

- [What is Unimeter](https://unimeter.io/what-is-unimeter/): Overview and use cases
- [Quickstart](https://unimeter.io/quickstart/): Run Unimeter and record your first event
- [Events and metrics](https://unimeter.io/concepts/events-and-metrics/): Core data model
- [Metric types](https://unimeter.io/concepts/metric-types/): COUNT, SUM, MAX, LATEST, COUNT_UNIQUE
- [Filters and dimensions](https://unimeter.io/concepts/filters/): Slice usage by tags
- [Alerts](https://unimeter.io/concepts/alerts/): Threshold-based notifications
- [Go SDK](https://unimeter.io/sdk/go/): Full Go client reference
- [Python SDK](https://unimeter.io/sdk/python/): Full Python async client reference
- [Stripe integration](https://unimeter.io/guides/stripe/): Connect Unimeter to Stripe billing
- [Meter LLM usage like Anthropic](https://dev.to/0x180db/meter-llm-usage-like-anthropic-tokens-models-weekly-and-monthly-caps-4302): Token metering with per-model rates and weekly/monthly caps (external)
- [Running a cluster](https://unimeter.io/operations/cluster/): Multi-node deployment
- [Observability](https://unimeter.io/operations/observability/): Prometheus metrics and Grafana
- [Operational runbook](https://unimeter.io/operations/runbook/): Recovery, scale-out, common failures
- [Benchmarks](https://unimeter.io/operations/benchmarks/): Methodology and bare-metal results
- [Architecture](https://unimeter.io/operations/architecture/): How it stays fast

## SDKs

- Go: `go get github.com/unimeter/go-unimeter@latest`
- Python: `pip install unimeter-python` (Python 3.11+, asyncio)
- TypeScript: planned

## License

Source-available under the [O'Saasy License](https://osaasy.dev/): MIT-style with SaaS rights reserved.

## Full docs for LLMs

For the complete documentation in a single file optimized for LLM context, see [llms-full.txt](https://unimeter.io/llms-full.txt).