index.md

<style> .project-logos img { transition: transform 0.3s ease; } .project-logos img:hover { transform: scale(1.1); } </style>

BalatroBot
API for developing Balatro bots BalatroLLM
Play Balatro with LLMs BalatroBench
Benchmark LLMs playing Balatro

---

BalatroBot is a mod for Balatro that serves a JSON-RPC 2.0 HTTP API, exposing game state and controls for external program interaction. The API provides endpoints for complete game control, including card selection, shop transactions, blind selection, and state management. External clients connect via HTTP POST to execute game actions programmatically.

• :material-download:{ .lg .middle } Installation

  ---

  Setup guide covering prerequisites and BalatroBot installation.

  :octicons-arrow-right-24: Installation

• :material-robot:{ .lg .middle } Example Bot

  ---

  A minimal Python bot example to get started with BalatroBot.

  :octicons-arrow-right-24: Example Bot

• :material-console:{ .lg .middle } CLI Reference

  ---

  Command-line interface for launching Balatro with BalatroBot.

  :octicons-arrow-right-24: CLI Reference

• :material-file-document:{ .lg .middle } BalatroBot API

  ---

  Message formats, game states, methods, schema, enums and errors

  :octicons-arrow-right-24: API Reference

• :octicons-people-24:{ .lg .middle } Contributing

  ---

  Setup guide for developers, test suite, and contributing guidelines.

  :octicons-arrow-right-24: Contributing

• :octicons-sparkle-fill-16:{ .lg .middle } Documentation for LLM

  ---

  Docs in llms.txt format. Paste the following link (or its content) into the LLM.

  :octicons-arrow-right-24: llms-full.txt