A fast, native Rust CLI for finding and inspecting Balatro seeds by joker, ante, boss, voucher, tag, pack contents, card properties, and other run conditions.
Go to file
Dandaedre 29b7a328a9
Rust CI balatro-seed-search passed CI.
MadGobblins/balatro-seed-search/pipeline/head This commit looks good Details
cli: find jokers in booster packs
2026-10-08 15:55:59 +02:00
benches build: configure rust_realease publishing 2026-10-06 19:29:51 +02:00
docs cli: find jokers in booster packs 2026-10-08 15:55:59 +02:00
examples build: configure rust_realease publishing 2026-10-06 19:29:51 +02:00
src cli: find jokers in booster packs 2026-10-08 15:55:59 +02:00
tests fix: align shop generation with reference RNG and pools 2026-10-07 20:51:11 +02:00
.gitignore chore: remove superseded non-native applications 2026-10-06 19:08:06 +02:00
ACCEPTANCE.md refactor: flatten native Rust package 2026-10-06 19:27:37 +02:00
AGENT.md chore: remove superseded non-native applications 2026-10-06 19:08:06 +02:00
CHANGELOG-NATIVE.md release: prepare v0.1.1 2026-10-07 21:47:31 +02:00
Cargo.lock release: prepare v0.1.1 2026-10-07 21:47:31 +02:00
Cargo.toml release: prepare v0.1.1 2026-10-07 21:47:31 +02:00
Cross.toml build: configure rust_realease publishing 2026-10-06 19:29:51 +02:00
Jenkinsfile ci: add Jenkins pipeline 2026-10-06 20:45:57 +02:00
LICENSE Initial scaffold: Rust engine + WASM + web/server skeleton 2026-06-28 21:24:57 +00:00
PERFORMANCE.md perf: evaluate native search acceleration 2026-10-06 19:54:53 +02:00
README.md cli: find jokers in booster packs 2026-10-08 15:55:59 +02:00
TASK.md cli: find jokers in booster packs 2026-10-08 15:55:59 +02:00
rust-release.toml build: move canonical repository 2026-10-06 19:55:53 +02:00

README.md

Balatro Seed Search

A native Rust command-line tool for finding and inspecting Balatro seeds by joker, ante, boss, voucher, tag, pack contents, card properties, and other run conditions. It is intended for seed hunters who want a fast, scriptable search without a browser or graphical interface.

Requirements and build

Install a current stable Rust toolchain, then build from the repository root:

git clone https://proxy.dandaedre.com/gitea/MadGobblins/balatro-seed-search.git
cd balatro-seed-search
cargo build --release --locked --bin balatro-seed-search

The binary is written to target/release/balatro-seed-search.

Quick start

Find the first seed in a small range containing Blueprint on or before ante 2:

./target/release/balatro-seed-search find-jokers \
  --joker Blueprint --before-ante 2 \
  --max-seeds 1000 --max-matches 1 --threads 1 \
  --progress 0 --output seeds

Expected standard output:

11111122

--before-ante is inclusive. Repeat --joker to require multiple jokers, or add --mode any to accept any requested joker. Run balatro-seed-search find-jokers --help for every available search control. Use --pack-joker NAME to search Buffoon-pack contents instead of shop slots.

Shop results use the post-1.0.1c joker pools and report positions in an ante's shop queue. --max-rerolls assumes one two-card shop visit; purchases, unlocks, and later visits are not simulated. See correctness limits.

Documentation

Credits, license, and support

The original seed-search engine and application were created by Julie (JupiterianSoul). All credit for the original Rust engine, Balatro RNG implementation, derivation logic, filters, tables, validation tools, and initial application belongs to her. Later work repackages and extends that foundation as a native-only CLI.

This project preserves Julie's MIT license. Report bugs and request features in the canonical Gitea issue tracker.