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.
Warning
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.
https://coder.github.io/balatrobot/
This project is a fork of the original balatrobot repository. We would like to acknowledge and thank the original contributors who laid the foundation for this framework:
The original repository provided the initial API and botting framework that this project has evolved from. We appreciate their work in creating the foundation for Balatro bot development.
- BalatroBot: API for developing Balatro bots
- BalatroLLM: Play Balatro with LLMs (coming soon)
- BalatroBench: Benchmark LLMs playing Balatro (coming soon)