Vibe ChessVibe Chess

What Vibe Chess is (the chess bot and app)

Alexey Mudry
Vibe Chess is a free app and Telegram bot that take on all the routine of a chess tournament: pairing by FIDE rules, sending the pairs out to the tables, collecting results from the players themselves, working out the table with the Buchholz score and exporting the finished event as a report in TRF format. The organiser is left with the venue, the boards and the people - the service takes the arithmetic and the paperwork. This page is a table of contents: a short account of how it all works, and links to detailed write-ups of each part.

The short version

  • It works right inside Telegram - Vibe Chess Bot, there is nothing to install and you sign in with your account.
  • Besides the bot there is an app: the city event listing, the field of a tournament, the live table, the state of the round, your profile and your game history - everything that is awkward to read as messages.
  • The pairing is calculated by an engine by FIDE rules (the Dutch system): score groups, floats when the field is odd, colour alternation, no repeat meetings and no two byes in a row.
  • The finished tournament is exported as a report in TRF format - the official FIDE data exchange format, accepted by arbiting software and federations.
  • The players enter the results themselves with buttons. If the two sides disagree, the bot flags a dispute and calls the organiser.
  • The table with points and Buchholz is recalculated after every round, and every player can see it.
  • The organiser adds players without Telegram as guests, by name.
  • The interface is translated into 11 languages. Everything listed here is free: no subscriptions, no paid tiers and no limits on the number of tournaments or players.
  • There is a fallback version for the browser - an online tournament. You need it for the case where Telegram is not working for most of the players: the organiser creates the tournament right on the site. It has fewer features than the bot, but the tournament goes ahead.

Where to start

You are the organiser

Create a tournament, open registration, start the rounds and get a finished table.

The organiser's guide
You are a player

Sign up for a tournament, find out your opponent and your table, and send in your result.

The player's guide
No Telegram

The organiser adds a player without a messenger as a guest, by name - they play on equal terms with everyone else.

How it works

How a tournament runs: five steps

The scheme is the same for blitz in the office and for a club rapid at the weekend.

  1. 1Creating it. The wizard in the bot asks for the name, the date and start time and the number of rounds, and at the end for the player limit, the entry fee and a description. The optional fields can be skipped.
  2. 2Registration. Players find the tournament in the list for their city and sign up themselves. The organiser enters guests without Telegram.
  3. 3The pairing. Entries close, the field is fixed, and the bot deals out the pairs: everyone gets a table number and an opponent.
  4. 4Results. After the game the players press a button with the outcome. If they agree, the result is accepted; if they differ, the organiser decides.
  5. 5The next round. The table is recalculated automatically and a new round starts. After the last one the bot announces the final standings.

At any moment a player can see /my_pairing - their pair in the current round, and /standings - their position in the table.

A group playing chess on the embankment in the evening
This is how our players gather - the bot takes on the pairs and the table, and people are left with a real game

Where tournaments happen: ready-made scenarios

The rules are the same everywhere, but the timing, the prizes and the presentation depend a lot on the place. Write-ups for particular situations:

Work and companies
School and study
Leisure and friends
A game of chess on the embankment at sunset
One of our evenings on the embankment - the format the bot helps you repeat anywhere

Try it at your next tournament

The easiest way to understand it is in practice: open Vibe Chess Bot, create a trial tournament with your friends or colleagues and run one round through it. It takes a couple of minutes, and you will see straight away what the bot takes on.

Frequently asked questions

What is the Vibe Chess Bot in plain words?

It is a Telegram bot that runs a chess tournament in place of the organiser: it works out who plays whom in each round, sends the pairs to the players, takes in the results and keeps the table. You need it once more than eight people turn up and counting by hand gets hard.

How much does it cost?

It is free to use. There is no separate subscription, no limit on the number of tournaments and no paid features for running an event.

Do I have to install anything?

No. The bot works inside Telegram and you sign in with your account. If you prefer a computer, there is a browser version - also with nothing to install.

What system does the bot use to run the tournament?

The Swiss system: before each round your opponent is picked from the players on the same score. The bot does not pair people who have already met, it alternates colours, and with an odd field it gives somebody a bye. The final order is decided on points, and ties by the Buchholz score.

What if some of the players are not on Telegram?

The organiser adds them as guests, by name. Such a player enters the general pairing and plays on equal terms with everyone else; the only difference is that the organiser enters their results.

What if Telegram is not working for the players?

For that case the site has an online tournament section - a web version that opens in an ordinary browser. It is deliberately built as a fallback: if Telegram is unavailable for most of the players, the organiser creates and runs the tournament right on the site. It has fewer features than the bot, but it does the main thing - the tournament goes ahead, and the people who have already turned up to play do not have to go home.

What languages does the bot work in?

The interface is translated into 11 languages, and the language is picked up from your Telegram settings. That makes the bot usable for international and mixed groups.

What does the bot not do?

It does not play chess against you and it does not analyse games - it is an arbiter's tool, not an engine. Nor does it replace a live organiser when it comes to the venue, the equipment and the prizes: a person is still responsible for those.

The tournament app

Create your own tournament for free

The Vibe Chess app opens from a link and needs no installation. Setting up a tournament takes a minute: pick the system, set the date, the venue and the time control - the app handles the rest.

Swiss system

for a large field: opponents are matched by score, you choose the number of rounds

Round robin

for a small circle: everyone plays everyone, the round count follows from the field

Free meetup

no rounds, no pairings: players sign up and pick opponents at the table

How the tournament runs
  1. 1Create the event and share the link - sign-up opens right away
  2. 2Press start and the app announces the first pairing
  3. 3Enter results, the table with points and Buchholz updates itself
  4. 4At the end - final standings and a TRF report in the FIDE data exchange format

More than a bot: the app, FIDE rules and a TRF report

  • The app. Besides the bot there is an app - inside Telegram and simply at playvibechess.com/app: what is on in your city, the player list, a live table, the current round, your profile and game history - everything that is awkward to read as chat messages.
  • Pairings by FIDE rules. Pairings are computed by bbpPairings, an open-source engine implementing the Dutch system: score groups, floats on an odd field, colour alternation, no rematches and no two byes in a row.
  • A TRF report. A finished tournament exports as a single file in the FIDE data exchange format - the one arbiter software and federations accept. Your profile stores the FIDE ID, national federation code, title, sex and date of birth for it.
  • Free. All of the above, with no subscriptions, paid plans or limits on the number of tournaments and players.

Full overview

Missing a feature? Message the developers

The bot is constantly improved based on real tournaments. If you need a feature that isn't there yet, message the developers right inside the bot with the /support command. Many features appeared exactly because organizers asked for them, and useful ideas get added quickly.

What to read next

Step by step - the organiser's guide. Every feature - what the bot can do. Questions - the big FAQ. From scratch - how to run a tournament.

Alexey Mudry
Alexey Mudry · hosted 15 Vibe Chess events

At the board since childhood: hazy about his rating, precise about every rook he has blundered. Counts an evening as a good one if the opponent stayed to talk afterwards instead of rushing off to check with an engine. Message →