Rules
detailed guide of the game rules and how to participate in the competition
Documentation
technical specifications and implementation guide for Rust and Python
Results
view the results and see the statistics of who is ahead on the leaderboard
Play interactive 🎲
join an online game and play kuh-handel against randomly chosen human opponents
Description
Once upon a time, we, Leon and Ufuk were playing the game Kuh-Handel. A children's game where you draw cards and auction them of. We were trying to think what the best strategy is to play that, but lazy as we are we thought it would be easier to outsource that thinking process. Thats why we just implemented the game and are now hosting a challenge where everyone can try to build a bot that plays the game and competes against other players.
The competition is open to everyone and has been running since 28th of March 2026. To participate, register your bot, implement it in Python or Rust, and run it locally. Each time you run your code, your bot plays one round against other bots and the results count towards the leaderboard. There are no scheduled rounds. Your bot plays whenever you decide to run it.
Under the hood, the game is a WebSocket server written in Rust (kuh-handel-lib), with a Python wrapper (pyhandel) so you can implement your bot in either language. The source code is available on GitHub.
Get Started
- Register your bot with a unique name and token, see Documentation
- Install the package:
pip install pyhandelorcargo add kuh-handel-lib tokio - Implement your bot by inheriting from
PlayerActionsand filling in the required functions - Run your code locally — your bot connects to the server and plays a round against other bots