Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 0.4.2 instead.
Reason given by maintainers: superseded by the 0.3.0 open standard.

bohrin

CI License

Everyone tests the AI. Bohrin tests the test.

When you train a model with reinforcement learning, a program decides whether each task was solved. That program — the verifier — is the only thing the model learns from. If it is wrong, the model learns the defect, efficiently and without any visible symptom.

Measured on two widely used code-RL datasets, roughly one task in four accepts a patch that does not fix the bug.

Bohrin finds those tasks in your environments and reports one number.

What it does

This is a real run against scratchpad, a public environment in the verifiers repository — not an illustration:

$ pip install 'bohrin[verifiers]'
$ pip install ./environments/scratchpad      # a taskset is an installed package
$ bohrin audit ./environments/scratchpad --max-tasks 8 --unsafe-local

Bohrin  ·  environments/scratchpad
verifiers_v1 · 8 tasks · 3 probes · isolation: none
  note verifier code ran in-process with no isolation boundary

  determinism    ░░░░░░░░░░░░░░░  no variance observed in 5 runs
  ground_truth_rejected ░░░░░░░░░░░░░░░  the declared answer was accepted on
every task
  weak_oracle    ███████████████  8 tasks accept known-wrong solutions

  VERIFICATION GAP: 50 / 100   coverage: 3 of 3 probes

  EXPLOIT ▸ false_negation accepted on 8 tasks (reward 1)
           explicitly denies the declared answer 'alpha'
           example (task 0): The answer is not alpha.
           bohrin audit environments/scratchpad --task 0 --operator
false_negation --unsafe-local

  EXPLOIT ▸ identity_return accepted on 8 tasks (reward 1)
           echoes the prompt verbatim instead of answering
           example (task 0): Call the `scratchpad_roundtrip` tool with
word="alpha". It returns a single word. Then reply wi…
           bohrin audit environments/scratchpad --task 0 --operator
identity_return --unsafe-local

Findings are grouped by the operator that produced them, because one operator landing on eight tasks is one defect with one fix — not eight findings.

Every finding carries the candidate that passed, why it is wrong, and a command to reproduce it. That last line is copy-pasteable: running it re-runs exactly that one finding, against that one task, with that one operator.

In CI

An audit is exit 0 by default, whatever it finds, so adding Bohrin to a pipeline never breaks it by surprise. Ask for a gate when you want one:

bohrin audit ./environments/my-taskset --fail-on-gap 20
Exit Meaning
0 the audit ran; no gate was set, or the gate passed
1 a gate was set and the audit is over it
2 bad input, or the taskset could not be loaded
3 a gate was set but coverage was incomplete — no verdict, not a pass

Exit 3 is the one worth wiring up deliberately. A gate can pass because nothing was found, or because nothing was measured, and those are not the same claim — a taskset whose rewards all need a runtime measures nothing and would otherwise report a green build. Bohrin says it could not tell instead.

What that finding means

scratchpad grades with self.data.word in answer, and its own prompt contains word="alpha". So a model that echoes the prompt back scores full marks without ever calling the tool — on all 8 tasks.

That matters more than one weak grader. The environment exists to test per-rollout isolation, and its docstring offers a mean reward of 1.0 as the evidence that isolation holds. A mean reward of 1.0 is also what you get from a model that never touches the server, so the number does not support the conclusion drawn from it.

Bohrin reports this as an exploit rather than a lead because echoing the question is structurally not an answer — wrongness established without asking the verifier. Confirmed independently by scoring the same payload through verifiers directly, with Bohrin out of the loop.

Reading a taskset

Bohrin audits verifiers v1 tasksets. A taskset is an installed Python package, so install it before auditing the directory it came from.

Scoring invokes the task's reward functions directly — no agent, no model inference, no rollout — so an audit takes seconds.

A taskset that generates tasks forever is refused unless you bound it with --max-tasks N, rather than run until you notice.

What it will not do without being asked

Scoring runs the taskset's own code. Bohrin refuses to execute it with no isolation boundary unless you pass --unsafe-local, and the level it ran under is recorded in the report. A task whose reward function needs a runtime is refused rather than scored on a partial rubric, because a partial rubric awards full marks to a submission that does nothing.

The three open probes

Two directions of the same failure, and one check on the signal itself.

Weak oracle — will the verifier accept work that is provably incorrect? This is mutation testing with the roles relabelled: your verifier is the test suite, and a surviving mutant is a wrong solution it accepted.

Ground truth rejected — will the verifier reject work that is right? It submits the taskset's own declared answer, rendered every way the relation catalogue certifies as meaning-preserving, and reports tasks where none was accepted. A verifier that rejects correct answers trains a model away from correct behaviour: the gradient says the right answer was wrong. This probe reports findings but deliberately does not contribute to the Verification Gap — a verifier enforcing an output format its prompt documents looks identical to a broken one, and scoring them together would accuse the wrong party.

Determinism — does the verifier return the same reward for the same submission? A grader that disagrees with itself injects noise straight into the reward signal.

What they will and will not find

The open probes use six deterministic, model-free operators. They cost nothing but reward invocations and they are reproducible, but they do not find what a motivated attacker finds.

Across six verifiers v1 environments they reported one defect — scratchpad, above — and no false accusations. Of the other five: three measured clean at full coverage, and two Bohrin declined to score, saying so in the report rather than reporting them clean (gsm8k needs a runtime; reverse_text's own reference answer fails its own verifier).

Two of the three "clean" results are a limit of the operators, not a verdict on the grader. glossary accepts any reply containing the answer as a substring, and proposer_solver grades on the last integer in the reply. Both are exploitable; no fixed operator here constructs the payload that does it.

That gap is the honest boundary of the open core, and it is stated here rather than discovered later.

The rule this codebase is built around

Bohrin must never falsely accuse a verifier.

A missed exploit costs you one finding. A false accusation costs the tool its reason to exist. So a candidate is only reported as an exploit when its wrongness is established independently of the verifier being audited — everything else is a lead, not a finding. CI enforces this from both directions, including a clean fixture where any finding fails the build.

Runs on your infrastructure

Bohrin provisions no compute and transmits no environment data. It runs where your environments already run, and it refuses to execute generated candidates unless the required isolation properties are present.

Documentation

Document Contents
docs/01_ARCHITECTURE.md Layout, core types, plugin seam, concurrency, isolation
docs/02_VERIFICATION_GAP.md What the number means and how it is computed
docs/03_PROBES.md Probe designs, including what we refuse to do
docs/04_RELEASE.md What is open, what is not, and why

What Bohrin is not

  • It does not train models and does not provide a reward signal.
  • It does not host or execute environments.
  • It does not grade model outputs — that is a verifier's job. Bohrin grades the verifier.

Authorisation

Bohrin generates working exploits against verifiers. Audit only environments you own or are authorised to assess — the same norm the security industry applies to offensive tooling.

Not a novelty claim

The techniques are published. Weak oracle is mutation testing; the adversarial hacker/fixer loop is arXiv:2606.08960; the acceptance rates are arXiv:2606.16062. What Bohrin contributes is the productised system and its position — not the algorithms.

License

Apache-2.0. Copyright 2026 Bohrin.

Metadata

Release files for bohrin 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bohrin 1.1.0
File Size Uploaded
bohrin-1.1.0.tar.gz 140.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bohrin 1.1.0
File Interpreter ABI Platform
bohrin-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 220.3 kB

Release files / bohrin-1.1.0.tar.gz

Download URL bohrin-1.1.0.tar.gz
Size 140.5 kB
Tags Source
SHA-256 checksum
How to use checksums
33ba14582fbe132e09a643858d18f753e77bc3ee06e4b2e4071a19d602dd89ad
BLAKE2b-256 checksum
How to use checksums
272dbe4c87ba78e76bf70d599bd9ab377e7c1e0d75c06b749f991a3d3c818691
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.

Transparency log

Release files / bohrin-1.1.0-py3-none-any.whl

Download URL bohrin-1.1.0-py3-none-any.whl
Size 79.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c26906a3558add62c8bf239f72bbbeba1016161cc70fbccef47fb6b9d9d71140
BLAKE2b-256 checksum
How to use checksums
4e287eea0c83f9cb09f5ceefcf1c9bbce7366d6541f17aa13d85e92058fb9842
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.

Transparency log

Release history Release notifications | RSS feed

1.5.0

2 release files

1.4.0

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.0

2 release files

This release

1.1.0 This release

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release 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