| --- |
| title: README |
| emoji: 📊 |
| colorFrom: blue |
| colorTo: indigo |
| sdk: static |
| pinned: false |
| --- |
| |
| # Quantiles |
|
|
| **Open-source, local-first evaluation infrastructure for applied AI systems, designed for developer and coding-agent workflows.** |
|
|
| Quantiles gives developers a CLI and Python SDK for creating, running, analyzing, and comparing AI evaluations from their existing development environment. It records metrics, sample-level outputs, execution traces, and run history locally, making it easier to measure system behavior, detect regressions, validate changes, and ship higher-quality, more reliable AI systems. |
|
|
| With Quantiles, developers can: |
|
|
| - Run built-in benchmarks or create custom evaluations from configuration or Python. |
| - Debug individual samples with step-level inputs, outputs, metrics, and errors. |
| - Resume interrupted runs and reuse completed steps. |
| - Compare models, prompts, datasets, and configurations from the CLI. |
| - Run evaluation workflows with coding agents using the Quantiles agent skill. |
|
|
| ## Quickstart |
|
|
| Install the CLI and run SimpleQA Verified: |
|
|
| ```bash |
| curl -fsSL https://cli.quantiles.io/install.sh | bash |
| qt run simpleqa-verified |
| qt show 1 --json |
| ``` |
|
|
| This first run uses the built-in demo model, so it requires no model API key and incurs no inference cost. Use it to verify the workflow, then configure a provider-backed model for a real evaluation. |
|
|
| ## Documentation & Resources |
|
|
| - [Documentation](https://quantiles.io/documentation) — Everything needed to use Quantiles. |
| - [Quickstart](https://quantiles.io/documentation/quickstart) — Install Quantiles and run your first evaluation. |
| - [GitHub](https://github.com/quantiles-evals/quantiles) — Explore the source code and contribute. |
| - [Agent skill](https://github.com/quantiles-evals/skill) — Run and analyze AI evaluations with a coding agent. |
|
|
| ### Articles |
|
|
| - **Aug 4, 2026** | [Build an AI Evaluation from a Hugging Face Dataset Without Writing Python](https://huggingface.co/blog/phranzia/build-an-ai-evaluation-from-a-hugging-face-dataset) |
| - **Jul 27, 2026** | [Run and Compare AI Evaluations with a CLI for Developers and Coding Agents](https://huggingface.co/blog/phranzia/quantiles-local-ai-evaluation) |
|
|
| Quantiles is available under the [Apache License 2.0](https://github.com/quantiles-evals/quantiles/blob/main/LICENSE). |
