dmkononenko / telegram-chess

Add Inline Chess Game to your Telegram Bot

Telegram Chess Inline Bot

About

• A simple and efficient Telegram bot for playing chess, built using Aiogram.
• This bot operates in inline mode, allowing users to play chess with other chat participants.
• All moves are reflected and updated in the original message, ensuring a seamless gaming experience.

Dependencies

This project utilizes the python-chess library by niklasf for chess logic and operations.

Try Before Install

Want to give it a shot before installing? It's easy! Simply type @nujno_mnogo_rabot in any chat on Telegram and click "Play Chess".

Installation

1. Install via pip

pip install telegram-chess

2. Manual Installation

• Download the telegram_chess.py file.
• Place it in your project directory.

Usage with Aiogram 3.0.1

from aiogram import Bot, Dispatcher, Router, types, F
from aiogram.enums import ParseMode
from aiogram.types import Message, InlineQuery
import asyncio

from telegram_chess import TelegramChess

TOKEN = "BOT_TOKEN_GOES_HERE" 
bot = Bot(token=TOKEN, parse_mode=ParseMode.HTML)
dp = Dispatcher()

chess_game = TelegramChess()

@dp.inline_query()
async def inline_echo(inline_query: types.InlineQuery):
    await chess_game.answer_with_inline_chess_query(inline_query)

@dp.callback_query(F.data.startswith(chess_game.chess_data_start))
async def handle_callback(callback_query: types.CallbackQuery):
    await chess_game.make_move(callback_query, bot)

async def on_startup():
    print("Welcome to Chess Bot by @EnMind")

async def main() -> None:
    await dp.start_polling(bot)
    await on_startup()

if __name__ == "__main__":
    asyncio.run(main())

Enjoy playing chess with your friends on Telegram!