yukibot API Reference

Welcome to the official yukibot Python library documentation. A simple, synchronous, Telebot-like wrapper around the YukiChat Bot API, fully optimized for Cloudflare D1.

Quick Start

Install the library and initialize your bot in just a few lines of code.

pip install --upgrade yukibot
from yukibot import YukiBot

bot = YukiBot("yk_bot_YOUR_TOKEN_HERE")

@bot.message_handler(commands=['start'])
def send_welcome(message):
    bot.reply_to(message, "Hello! I am a YukiChat Bot built with Python.")

if __name__ == '__main__':
    bot.polling()

Below is the complete reference for all **87 API methods** mapped directly to Python functions inside the YukiBot class.

Changelog

Tracking new features, updates, and fixes for the yukibot Python library.

v1.1.0
April 26, 2026
  • ADD Added 50 new API methods to provide full feature parity with the backend.
  • ADD New media sending methods: sendVoice, sendVideoNote, sendPoll.
  • ADD Full Chat Management: getChatAdministrators, setChatPermissions, banChatMember.
  • ADD Bot Profile Management: setMyName, setMyBio, setMyProfilePhoto.
  • ADD Dynamic UI methods: setChatTheme, setChatBackground, setChatEmojiEffect.
  • ADD RTC & Call Integration: initiateBotCall, getCallStatus, sendCallSignal.
  • ADD User & History access: getUserProfilePhotos, getChatHistory, getUserStatus.
  • UPDATE Upgraded sendMessage and other media methods to support expires_in for self-destructing messages.
  • UPDATE Enhanced answerCallbackQuery to support sending toast alerts to the user's UI.
  • FIX Corrected parameter mapping for several existing methods to match backend updates.

Architecture & Data Flow

YukiChat is built entirely on Cloudflare's Edge network. The yukibot library is designed to seamlessly interface with this infrastructure, offering smart D1 caching to automatically save on database read quotas.

YukiChat Client App
↓ REST API / WebSocket
Cloudflare Edge Worker
↓ SQL Queries
Cloudflare D1 (Database)
↓ Polling / Webhook
Your Python Server