Repository navigation
The first release, an alpha. Break runs an agent many times while changing how its tools behave
and what the user asks, keeps the conditions that fail more than a control, confirms them on
fresh runs with Poisson Trace's test, and checks a fix against them later. This version has one
way in, rollout (an agent Break calls as a Python function), ten tool faults, five input
operators, two search strategies that do not learn, and eight commands.
What a first user gets:
pip install poisson-break, thenpoisson-break init --example desk,hunt --yesand
confirm --yesend with three findings on a help desk agent, with no key and no network.- Five examples, each written into a folder by
init --example NAMEand each run offline
against a scripted model:desk,full-loop(hunt, confirm, a fix, recheck),stand-in(a
write tool that is never really called),own-check(a failure rule of your own) and
own-fault(a fault of your own). They ride in the wheel. - The docs: the catalogue, reading a finding, checking a fix, the rollout way in, recipes for
making cases from LangSmith, Langfuse and Phoenix exports, what Break does not claim, and one
page for each of the four extension points, and a reference for the commands, the settings
file, the stored runs and the library. Every command the README and the docs show is
run in CI from the installed wheel, and every program they show is run there too. catalog --labelsshows, beside a change, the labels it carries from the OWASP Top 10 for
LLM Applications 2025 and NIST AI 100-2 E2025, where the table has a row for it. Each row
quotes the published text it rests on.
Install
python -m venv .venv
. .venv/bin/activate
pip install poisson-break
poisson-break init --example desk
poisson-break hunt --yes
poisson-break confirm --yesBreak needs Python 3.11 or later, on macOS or Linux. pip installs poisson-prove 0.1.3 and poisson-trace 0.1.0a1 with it, each at that exact version. Run Break against a test environment: it calls your tools for real.
More
- On PyPI: https://pypi.org/project/poisson-break/0.1.0/, published on 2026-11-16 from this tag.
- The README: https://github.com/poisson-labs/break/blob/v0.1.0/README.md
- Everything in the release, module by module: CHANGELOG.md
- What Break does not claim: https://github.com/poisson-labs/break/blob/v0.1.0/docs/claims.md