BalatroBot
API for developing Balatro bots
Play Balatro with LLMs
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.
Breaking Changes
BalatroBot 1.0.0 introduces breaking changes:
- Now a CLI to start Balatro (no longer a Python client)
- New JSON-RPC 2.0 protocol over HTTP/1.1
- Updated endpoints and API structure
- Removed game state logging functionality
BalatroBot is now a Lua mod that exposes an API for programmatic game control.
-
Installation
Setup guide covering prerequisites and BalatroBot installation.
-
Example Bot
A minimal Python bot example to get started with BalatroBot.
-
CLI Reference
Command-line interface for launching Balatro with BalatroBot.
-
BalatroBot API
Message formats, game states, methods, schema, enums and errors
-
Contributing
Setup guide for developers, test suite, and contributing guidelines.
-
Documentation for LLM
Docs in llms.txt format. Paste the following link (or its content) into the LLM.