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, CPU-only hardware supported

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
pyrecall learn train.jsonl --snapshot-after after_v1
pyrecall check --before before_v1 --after after_v1
# 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.11.7.tar.gz (151.9 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.11.7-py3-none-any.whl (87.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pyrecall-0.11.7.tar.gz
  • Upload date:
  • Size: 151.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pyrecall-0.11.7.tar.gz
Algorithm Hash digest
SHA256 0173f4efefff941ab60198c5cdf2e0b5b226f388098169d8054253f6aec184da
MD5 09c498c1532d8f3fd3a8a6f7c221409a
BLAKE2b-256 b37e32457316a0fabd37c7cd3901627ddaeb8c25ebf6d4984f6cd444e1bd28b2

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyrecall-0.11.7.tar.gz:

Publisher: publish.yml on Pyrecall/Pyrecall

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

  • Download URL: pyrecall-0.11.7-py3-none-any.whl
  • Upload date:
  • Size: 87.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pyrecall-0.11.7-py3-none-any.whl
Algorithm Hash digest
SHA256 2951dc7b0f43fb12212cba582a644215828f073466cdb8eecb08ec23e630d938
MD5 b112b0f9339a6ef32891a5416bf3eb09
BLAKE2b-256 d645caeaa279d13fc07570c42aea668698a0d3db2e1197821370673ca97f4a71

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyrecall-0.11.7-py3-none-any.whl:

Publisher: publish.yml on Pyrecall/Pyrecall

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.12.1

2 files

0.12.0

2 files

0.11.11

2 files

0.11.10

2 files

0.11.9

2 files

0.11.8

2 files

This release

0.11.7 This release

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