# FluxMeter

> Open-source real-time, token-native metering for AI APIs, token resellers, and multi-tenant gateways. Engine v3.2.2 · Python SDK 1.5.0.

## What it does

**Core — Token-native metering**
- Ingest via SDK, HTTP, or Gateway
- Price against a model catalog (tiers)
- Query per-downstream-customer usage: period / day / model (`GET /usage/customer/...`)
- Lite (`make demo`) for quick start; Full for 1M+ eps (Kafka + Flink)
- Reseller demo: `make demo-reseller`

**Optional — Hard gate**
- Pre-request budget check (`GET /budget/{id}/check`)
- Reserve / reconcile for streaming; mid-stream kill via Gateway or `wrap()`
- Soft alerts and hierarchy caps

**Advanced — Intelligence (later)**
- Root cause, unit economics, simulation on the same metered data
- Complements invoice platforms — does not replace invoicing, tax, or MoR

## Positioning

Real-time, token-native metering for AI APIs & gateways.
vs OpenMeter / Lago / Metronome: we lean runtime metering correctness + optional hard gates; they lean usage → invoice. Complementary.

## Quick start

```bash
git clone https://github.com/10kshuaizhang/fluxmeter.git
cd fluxmeter
make demo
make demo-reseller
```

## Links

- Website: https://fluxmeter.dev
- Website (中文): https://fluxmeter.dev/zh/
- Market map: https://fluxmeter.dev/market-map
- Docs hub: https://fluxmeter.dev/docs
- Gateway: https://fluxmeter.dev/docs/gateway
- API reference: https://fluxmeter.dev/docs/api
- Intelligence (advanced): https://fluxmeter.dev/docs/intelligence
- Changelog: https://fluxmeter.dev/changelog
- OpenAPI: https://fluxmeter.dev/openapi.yaml
- Customers: https://fluxmeter.dev/customers
- FAQ: https://fluxmeter.dev/faq
- Blog: https://fluxmeter.dev/blog
- Compare: https://fluxmeter.dev/compare
- Full product summary: https://fluxmeter.dev/llms-full.txt
- Source code: https://github.com/10kshuaizhang/fluxmeter
- PyPI: https://pypi.org/project/fluxmeter/

## License

Apache 2.0