# Metrics documentation

Metrics by 041 is ML experiment tracking built for research agents and the
people who work with them. A training job logs with the Python collector; agents
and scripts read back with the command line, DuckDB or the Python API client;
people look at charts in the app. These pages say what is true for someone doing
that. Each page is short and answers one question; follow the links for the
rest.

Every page is plain markdown. The site serves the same text at
`/docs/<page>.md`, answers any page with markdown for curl or
`Accept: text/markdown`, and `/llms.txt` lists every page.

## Start here

- [Why Metrics](https://metrics.041.io/docs/why.md) — what experiment tracking needs when agents run the
  research, and what we left out
- [Quickstart](https://metrics.041.io/docs/quickstart.md) — sign in, log a first run from Python and read it
  back, in five minutes
- [Working as an agent](https://metrics.041.io/docs/agents.md) — the command line, keys, markdown docs and
  the habits that keep results honest
- [Concepts](https://metrics.041.io/docs/concepts.md) — organizations, folders, experiments, metrics,
  metadata and annotations

## Log

- [The collector](https://metrics.041.io/docs/collector.md) — `syvain-metrics-collector`: the Python API,
  its arguments and what it guarantees
- [What to log](https://metrics.041.io/docs/logging-guide.md) — names, metadata, cadence and the field every
  value belongs in

## Read and analyze

- [Command line](https://metrics.041.io/docs/cli.md) — `syvain-metrics`: sign-in, folders, experiments,
  series and charts as JSON
- [DuckDB](https://metrics.041.io/docs/duckdb.md) — the `syvain_metrics` extension: tables, selectors, the
  cache and example queries
- [Python API client](https://metrics.041.io/docs/python-client.md) — `syvain-metrics-api-client`: folders,
  experiments and series from scripts

## The app

- [Using the app](https://metrics.041.io/docs/app.md) — the folder tree, the loss chart, diagnostics, chart
  controls and saved views

## Organizations

- [Organizations and keys](https://metrics.041.io/docs/organizations.md) — members, invitations, roles and
  API keys, from the app or the CLI
- [Limits and fair use](https://metrics.041.io/docs/limits.md) — every limit the API enforces, what free
  means, and how to ask for more

## HTTP API

- [HTTP API](https://metrics.041.io/docs/api.md) — authentication, event envelopes, batches, errors, retries
  and streaming series
- [API events](https://metrics.041.io/docs/api-events.md) — every v2 event with its data and reply,
  generated from the API contracts

## Under the hood

- [Series storage](https://metrics.041.io/docs/series-storage.md) — Syvain Series DB, the storage we built
  for experiment metrics: lossless, fast and cheap to run

---

Metrics by 041 documentation. Every page: https://metrics.041.io/llms.txt