BalatroBot

BalatroBot
BalatroBot
API for developing Balatro bots
BalatroLLM
BalatroLLM
Play Balatro with LLMs
BalatroBench
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.

  • Installation


    Setup guide covering prerequisites and BalatroBot installation.

    Installation

  • Example Bot


    A minimal Python bot example to get started with BalatroBot.

    Example Bot

  • CLI Reference


    Command-line interface for launching Balatro with BalatroBot.

    CLI Reference

  • BalatroBot API


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

    API Reference

  • Contributing


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

    Contributing

  • Documentation for LLM


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

    llms-full.txt