Skip to main content

pyrecall

PyPI version CI License: MIT Python 3.11+ PyPI Downloads

Forgetting detection and skill rollback for fine-tuned LLMs.

Fine-tune on new data and your model quietly loses what it already knew — coding ability, reasoning, safety guardrails. pyrecall catches it before it ships.


Install

pip install pyrecall   # Python 3.11–3.14 · CUDA, MPS, and CPU

Quickstart

from pyrecall import Model

model = Model("meta-llama/Llama-3.2-1B")
model.snapshot("before")
model.learn("data.jsonl", epochs=3)

if not model.check().is_healthy:
    model.rollback(to="before")
pyrecall init --model meta-llama/Llama-3.2-1B
pyrecall snapshot before_v1                        # baseline before training
pyrecall learn train.jsonl --snapshot-after after_v1  # train + snapshot in one step
pyrecall check                                     # compares last two snapshots
# exit 0 → ship   exit 2 → pyrecall rollback before_v1

How it works

Benchmarks 180 prompts across 9 skill categories (reasoning, coding, safety, math, multilingual, and more) using log-likelihood scoring. After training, check diffs the scores and flags any category that drops past your threshold (default 10%). Only the LoRA adapter is stored per snapshot — a few hundred MB, not the full model.

Any causal LM on HuggingFace Hub is supported — Llama, Mistral, Phi, Gemma, Qwen, Falcon, GPT-2/Neo/J, and more. LoRA targets are auto-detected.


Docs

Full CLI reference, Python API, experiment tracker integrations (W&B, MLflow, Neptune), custom benchmarks, per-category thresholds, and more:

pyrecall.github.io/Pyrecall


Contributing

git clone https://github.com/Arths17/Pyrecall
pip install -e ".[dev]"
pytest

Open an issue before large changes. MIT — LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyrecall-0.12.0.tar.gz (175.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyrecall-0.12.0-py3-none-any.whl (99.9 kB view details)

Uploaded Python 3

File details

Details for the file pyrecall-0.12.0.tar.gz.

File metadata

  • Download URL: pyrecall-0.12.0.tar.gz
  • Upload date:
  • Size: 175.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for pyrecall-0.12.0.tar.gz
Algorithm Hash digest
SHA256 1c0fb5efdf9e1a31a5f48ec219e2b4eba29955fe873f0b6cdc26e6db779fcec3
MD5 3b824e814c49fbbfc0d54543b24da783
BLAKE2b-256 de8c3a9f4a67545f5387f4422ca675f15f7affe582fac2f0d2f12dbfcf0cd226

See more details on using hashes here.

File details

Details for the file pyrecall-0.12.0-py3-none-any.whl.

File metadata

  • Download URL: pyrecall-0.12.0-py3-none-any.whl
  • Upload date:
  • Size: 99.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for pyrecall-0.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 37ec046261603a6cdd510ca45eb2762c4f60e0b59de26cf800a9b6f471385bf3
MD5 91fc7f814436ed09ce17b17f2d65abdf
BLAKE2b-256 45a0caa4ec50ff69a3123f7baadfc1b315329d36c51a52932b9447bbdce739a0

See more details on using hashes here.

Release history Release notifications | RSS feed

0.12.1

2 files

This release

0.12.0 This release

2 files

0.11.11

2 files

0.11.10

2 files

0.11.9

2 files

0.11.8

2 files

0.11.7

2 files

0.11.6

2 files

0.11.5

2 files

0.11.4

2 files

0.11.3

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.1

2 files

0.10.0

2 files

0.9.0

2 files

0.8.0

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.6

2 files

0.1.5

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page