Apeiron

A PyTorch framework for continual learning that detects concept drift in a live data stream and adapts the model in place.

Apeiron runs a monitoring loop over a changing data stream, watches an evaluation metric, hands that metric to a drift detector, and — when the detector fires — pauses monitoring to run a continual-learning update on the model before resuming.

Run a bundled example
uv run python -m src.main --config examples/mnist/mnist.toml

The loop

  1. Evaluate the current model on stream batches.

  2. Aggregate the monitored metric at a configured interval.

  3. Run a drift detector on the aggregated metric.

  4. On drift, pause monitoring and run a continual-learning update loop.

  5. Resume monitoring on the updated model until stream limits are reached.

Get started

Install Apeiron and run your first drift-detection experiment.

Quickstart
Configuration reference

Every TOML section and key the config parser accepts, with defaults.

Apeiron Configuration Reference
Drift detectors

Detector classes, their options, and how detector output drives training.

Drift Detectors
Continual learning

The CL trainer, the updater modes, and what runs after drift is detected.

Continuous Learning

Suggested reading order

  1. Installation and Quickstart — get a run going.

  2. Architecture — how the pieces fit together at runtime.

  3. Apeiron Configuration Reference — the required and optional configuration parameters.

  4. Model Harness — how your model and stream loaders are exposed to the framework.

  5. Drift Detectors — how monitoring decisions are made.

  6. Continuous Learning — what happens after drift is detected.

  7. Tracking Runs — sending run metrics to Weights & Biases or MLflow.

Contributing

Contribution guidelines, including our guidelines for AI/LLM-assisted contributions, are in CONTRIBUTING.md.

License

Apeiron is released under the Apache License 2.0.

Support

This work was supported by the U.S. Department of Energy (DOE), Office of Science, Office of Advanced Scientific Computing Research in alignment with DOE’s Genesis Mission.