Balatro Seed Oracle

Search millions of Balatro seeds to find the perfect runs for your strategies.

Balatro Seed Oracle (BSO) is an Avalonia UI desktop application for Windows, Linux, and macOS. Seed searching is provided by Motely (MotelyJAML), included as a git submodule (fork of tacodiva/Motely).

What is this?

Balatro Seed Oracle helps you find specific Balatro seeds based on detailed criteria:

• Find exact joker combinations - Blueprint + Brainstorm in specific antes
• Locate rare voucher chains - Telescope → Observatory progressions
• Hunt for soul jokers - Negative Perkeo with specific pack requirements
• Search for perfect setups - Specific bosses, tags, spectral cards, etc.

Built for the Balatro community to discover optimal seeds for challenge runs, high scores, and specific strategies.

Installation

Requirements

• Windows, Linux, or macOS*
• Intel, AMD, or Apple Silicon CPU**
• .NET 10 SDK
• git]

NOTE on other compatibilities

• Not sure if other OS will work such as BSD, but it probably will.
• I think this might work on other CPUs like ARM, but I have not tested it.
• I think I might need some changes to Motely's Vector helpers to make it work, but it's possible the fallbacks (if AVX512 and/or AVX2 not supported) tacodiva added already will be compatible.
• Mobile support is planned for future releases.

Clone this repository (or download zip, or use Github Desktop)

Either click the green button in the upper-right of this page and download in your favorite way...or:

git clone https://github.com/OptimusPi/BalatroSeedOracle.git
cd BalatroSeedOracle
dotnet run -c Release --project ./src/BalatroSeedOracle.Desktop/BalatroSeedOracle.Desktop.csproj

Initialize the git Submodule

This repo uses a git submodule for the Motely (MotelyJAML) search engine at src/MotelyJAML (fork of tacodiva/Motely, with MotelyJson support). You must initialize and update the submodule after cloning:

git submodule update --init --recursive

Run the Balatro Seed Oracle GUI Application

If you are making code changes on your own fork for example, you can specify Debug build configuration. NOTE: This searches a lot slower than release version!

dotnet run -c Debug --project ./src/BalatroSeedOracle.Desktop/BalatroSeedOracle.Desktop.csproj

To run the optimized release build:

dotnet run -c Release --project ./src/BalatroSeedOracle.Desktop/BalatroSeedOracle.Desktop.csproj

Using the Command Line Interface

For advanced users who prefer CLI usage, the bundled MotelyJAML search engine supports command-line operation with JSON/JAML filters, native C# filters, and seed analysis.

See the MotelyJAML README for complete CLI documentation.

Quick CLI example:

cd ./src/MotelyJAML
dotnet run -- --help

Creating Filters

Visual Editor

Use the in-app visual filter designer to create complex filters by dragging and dropping criteria.

JAML Configuration

Filters are authored in JAML (Jimbo's Ante Markup Language), a YAML dialect. This is the only format the app loads — there is no JSON load path. Create custom filters manually:

name: Negative Perkeo Hunt
mode: sum            # optional: "sum" (default), "max", or "max_count"
deck: Red
stake: White
must:
  - voucher: Telescope
    antes: [1, 2]
  - legendaryJoker: Perkeo
    edition: Negative
    antes: [1, 2, 3]
should:
  - joker: Blueprint
    antes: [2, 3, 4]
    score: 10

Clause discriminators are keys (joker:, voucher:, legendaryJoker:, tarotCard:, spectralCard:, planetCard:, boss:, tag:, ...), not a type/value pair. Names are PascalCase with no spaces (Blueprint, SixthSense). Ante 0 is the Soul/legendary slot before ante 1.

Filter Types

• Vouchers (voucher:): Telescope, Observatory, Hieroglyph, etc.
• Legendary Jokers (legendaryJoker:, the five that come from the Soul card): Perkeo, Triboulet, Canio, Chicot, Yorick.
• Regular Jokers (joker:): Blueprint, Brainstorm, Showman, etc.
• Tarot Cards (tarotCard:): TheFool, TheWorld, Death, etc.
• Spectral Cards (spectralCard:): Ankh, TheSoul, Wraith, etc.
• Planet Cards (planetCard:): Jupiter, Mars, Venus, etc.
• Playing Cards: Specific ranks/suits with seals/editions
• Boss Blinds: TheGoad, CeruleanBell, TheOx, etc.
• Tags: NegativeTag, SpeedTag, RareTag, etc.

Advanced Features

• Pack slot targeting: Find items in specific booster pack positions
• Shop slot filtering: Target specific shop positions
• Edition requirements: Negative, Polychrome, Foil editions
• Multiple clause logic: Complex AND/OR requirements

Performance

• Multi-threaded search - Utilizes all CPU cores
• SIMD vectorization - Hardware-accelerated filtering
• Smart caching - Optimized for repeated searches
• Batch processing - Configurable search chunk sizes

Typical speeds: 10-50 million seeds per second depending on filter complexity.

Scoring Modes

• mode: Controls how scores from should clauses are aggregated.
• Supported values: sum (default), max, max_count, maxcount.
• Behavior:
  • sum: Adds count * score for each should clause.
  • max: Uses the maximum raw occurrence count across all should clauses (per-clause score is ignored).
• Notes:
  • minScore in the Search modal is compared against the aggregated value from the selected mode.
  • Negative score values are allowed; they only affect sum mode.

Example using max aggregation:

name: Tarot or Planet Rush
mode: max
should:
  - tarotCard: TheFool
    antes: [1, 2, 3]
    score: 5
  - planetCard: Jupiter
    antes: [1, 2, 3]
    score: 50

In this example, even though the planet clause has higher score, mode: max ignores score and takes the higher raw occurrence count between the two clauses.

File Structure

• src/ – Main Avalonia application code (BalatroSeedOracle/ core + BalatroSeedOracle.Desktop/ head)
• src/MotelyJAML/ – Motely (MotelyJAML) git submodule; high-performance seed search engine
• JamlFilters/ – Pre-made JAML filter configurations (repo root)
• SearchResults/ – Database files with search results

Contributing

This is a community project. Contributions welcome:

• New filter configurations - Share effective seed hunt strategies
• Performance improvements - Optimization suggestions
• Bug reports - Issues with specific filters or seeds
• Feature requests - Additional filtering capabilities

Technical Details

Built on:

• .NET 10 / C# 14 – Modern C# with high performance features
• Avalonia UI – Desktop UI for Windows, Linux, and macOS (mobile scaffolding exists for the future)
• DuckDB – Fast analytical database for results (DuckDB.NET on Desktop)
• Motely (MotelyJAML) – Git submodule at src/MotelyJAML; vectorized Balatro seed search engine (JAML/JSON filters, CLI). Used by BSO for all seed searching.

The search engine uses advanced vectorized operations (SIMD) to achieve high throughput when analyzing millions of seed combinations.

Support

• Discord: Balatro community server (#tools channel)
• Issues: Open GitHub issues for bugs/requests
• Wiki: Check project wiki for advanced usage

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

---

Built by pifreak for the Balatro community