Home

Image title
A framework for developing Balatro bots

Pre-1.0 Development Notice

This project is currently in pre-1.0 development phase. According to Semantic Versioning specification, minor version updates (0.x.y → 0.(x+1).0) may introduce breaking changes. Please review release notes carefully before upgrading.

BalatroBot is a Python framework designed to help developers create automated bots for the card game Balatro. The framework provides a comprehensive API for interacting with the game, handling game state, making strategic decisions, and executing actions. Whether you're building a simple bot or a sophisticated AI player, BalatroBot offers the tools and structure needed to get started quickly.

  • Installation


    Setup guide covering prerequisites, Steamodded mod installation, and Python environment setup.

    Installation

  • Developing Bots


    Learn to develop bots with complete code examples, class structure, and game state handling.

    Developing Bots

  • Protocol API


    Technical reference for TCP socket communication, message formats, game states, and action types.

    Protocol API

  • Documentation for LLM


    Documentation in llms.txt format. Just paste the following link (or its content) into the LLM chat.

    llms-full.txt