Authorization notice. Modelprint is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Who it is forA contributor who has written or changed a probe in probes/ and wants to confirm it meets the project rules before opening a pull request.
The problemA probe that throws, returns timestamps, or gives a non-deterministic value will not be accepted, and the README lists those rules.
The outcomeA local pass or fail result from the mock-harness suite, and printed values from two real models if you have a key.
What you need first
- A web browser and an API key for the OpenAI-compatible endpoint you want to check
- Node.js, for the local test scripts (selftest.mjs, smoke.mjs, suspects.mjs)
- An OpenRouter API key in the environment, only for smoke.mjs and suspects.mjs
Steps
- Clone the repository with
git clone https://github.com/unclecode/modelprintand change into the folder. (inferred, check the README) - Copy
probes/_template.jsto a new file inprobes/and write your probe following the contract in the README. - Run
node selftest.mjsto test every probe against a mock harness; this needs no key. - Run
node smoke.mjswith an OpenRouter key in the environment to print values from two real models. - Add your probe to
probes/index.jsand your name to CONTRIBUTORS.md, then open a pull request.
Prompt for your agent
In the modelprint repo, add a probe in probes/ following probes/_template.js, then run `node selftest.mjs` from the repo root. Expected output: a pass result for every probe including the new one. Verify the new probe returns the same value on two runs and never throws before you open a pull request.
Caveat. The README says approved probes are one line in probes/index.js and that the project has security and determinism gates, so a passing local run does not guarantee acceptance.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for unclecode/modelprint and "Run the test suites before opening a probe pull request"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer