Skip to content
Itz-MuraliPublic

About

Your playful Telegram AI bestie, built in Ruby, deployed on Vercel.

Topics

Resources

Stars

74 stars

Watchers

1 watching

Forks

Latest commit

ย 

History

61 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Chiku Bot

๐‚ ๐šฎ ๐ˆ ๐Š ๐” ๐“†ฉ ๐”˜“ ๐“†ช

Your warm, playful Telegram AI bestie โ€” built in Ruby, deployed on Vercel.
Short replies. Natural vibes. Zero robotic energy.


๐ŸŒธ What is Chiku?

Chiku isn't your average chatbot. She's that friend who always knows what to say โ€” casual, warm, and genuinely fun to talk to. No essay-length replies, no weird robotic phrasing. Just natural, real-feeling conversations that make you forget you're chatting with a bot.

She works in private chats and group chats, responds when mentioned or replied to, and comes packed with 60+ reaction GIFs, anime images, AI image generation, Pinterest search, Pokรฉmon cards, admin tools, and much more.

Live on Telegram: @ChikuAiBot ยท Community: @ChikuBots


โœจ Feature Overview

Category What's included
๐Ÿค– AI Chat Natural conversation via Anya Api AI โ€” context-aware, short replies
๐ŸŽญ Reaction GIFs 60 anime reaction GIFs with tappable sender & target mentions
๐Ÿ–ผ๏ธ Anime Images Neko, waifu, husbando, kitsune via nekos.best
๐Ÿ“Œ Pinterest Search Image search with group send + one-by-one fallback
๐ŸŽจ AI Image Gen Text-to-image via Anya AI (Imagine API)
๐Ÿƒ Pokรฉmon Pokรฉmon info + official artwork by name
๐ŸŒค๏ธ Weather Live weather for any city
๐Ÿ’ฌ Fun & Games Quotes, facts, jokes
๐ŸŒ Translation Translate to 10+ languages
๐Ÿ“– Urban Dictionary Slang definitions
๐Ÿ›ก๏ธ Admin Tools Ban, kick, mute, unmute, pin, unpin, delete (group admins)
๐Ÿ”ง Dev Tools /eval Ruby, /sh shell (owner only)
๐Ÿ“ก Webhook Manager Enable/disable webhook from the landing page

๐ŸŽญ Reaction GIFs โ€” Full List (60 actions)

All reaction GIFs are powered by nekos.best. When used with a reply or mention, both the sender and target are shown as tappable hyperlink mentions.

Affection Playful Emotions Actions
hug ยท cuddle ยท pat poke ยท tickle ยท yeet cry ยท blush ยท pout wave ยท salute ยท nod
kiss ยท peck ยท blowkiss bonk ยท slap ยท punch happy ยท smile ยท wink run ยท spin ยท dance
handhold ยท lappillow baka ยท kick ยท bite angry ยท shocked ยท smug clap ยท highfive ยท thumbsup
kabedon ยท carry ยท feed nom ยท teehee ยท bleh confused ยท bored ยท think shake ยท handshake ยท tableflip
โ€” sip ยท nya ยท wag yawn ยท facepalm ยท shrug lurk ยท shoot ยท sleep ยท stare

๐Ÿ–ผ๏ธ Anime Images

/neko      โ€” Random neko image
/waifu     โ€” Random waifu image
/husbando  โ€” Random husbando image
/kitsune   โ€” Random kitsune image

All sourced from the nekos.best API.


๐Ÿ“Œ Pinterest Search

/pinterest <query>

Searches Pinterest for images and sends them as a Telegram media group.

๐ŸŽจ AI Image Generation

/imagine <prompt>
/imagine cute anime girl in cherry blossoms
/imagine dragon flying over a neon city at night

Generates an AI image from your prompt using Anya-Apis..


๐Ÿƒ Pokรฉmon

/pokemon <name>
/pokemon Pikachu
/pokemon Eevee

Fetches Pokรฉmon info and official artwork by name from the Pokรฉmon API.


๐ŸŒค๏ธ Weather

/weather <city>
/weather Tokyo
/weather New York

Returns current weather conditions, temperature, and description for any city.


๐Ÿ’ฌ Fun Commands

Command Description
/quote Random inspirational quote
/fact Random fun fact
/joke Random joke

๐ŸŒ Translation

Chiku can translate text to 10+ languages. Just ask naturally:

translate hello to japanese translate "good morning" to spanish


๐Ÿ“– Urban Dictionary

Look up slang and internet terms:

urban dictionary rizz what does bussin mean


๐Ÿ›ก๏ธ Admin Commands

These commands require group admin permissions (owner always bypassed):

Command Description
/ban [@user|reply] Ban a user from the group
/unban [@user|reply] Unban a user
/kick [@user|reply] Kick a user from the group
/mute [@user|reply] Mute a user (restrict messages)
/unmute [@user|reply] Unmute a user
/pin [reply] Pin a message
/unpin Unpin the current pinned message
/unpinall Unpin all messages in the chat
/del [reply] Delete a replied message

๐Ÿ”ง Developer / Owner Commands

Owner-only commands (IDs set in config.rb):

Command Description
/eval <ruby> Evaluate Ruby code in context
/sh <command> Run a shell command
/gcast <message> Broadcast a message to all known users/chats
/id Show user ID and chat ID
/info [@user|reply] Detailed user or chat info

โš™๏ธ General Commands

Command Description
/start Welcome message + intro
/help Full command list
/reactions List all 60 reaction GIF commands
/reset Clear AI conversation memory
/mood <vibe> Set Chiku's response mood

๐Ÿš€ Deployment

Chiku is designed to run serverlessly on Vercel using the @vercel/ruby runtime.

Prerequisites

  • Ruby 3.x
  • A Telegram bot token from @BotFather
  • A MongoDB connection string (for user/chat persistence with allowed all ip access)
  • Vercel account (free tier works)

Setup

1. Clone the repository

git clone https://github.com/Itz-Murali/Chiku-Ai.git
cd Chiku-Ai

2. Install dependencies

bundle install

3. Configure config.rb

TOKEN      = "your-telegram-bot-token"
BOT_ID     = TOKEN.split(':').first.to_i   # auto-derived
OWNER_IDS  = [your_telegram_user_id]
MONGO_URI  = "mongodb+srv://..."

4. Deploy to Vercel

vercel deploy

5. Register the webhook

Visit your deployment URL to trigger auto-registration:

GET https://your-deployment.vercel.app/api

Or use the Enable Chiku button on the landing page at your deployment URL.


๐Ÿซ‚ Credits



๐œœษดแƒง๊ซใ…ค๐“†ฉ๐Ÿ’—๐“†ช



๐Œ ๐” ๐‘ ๐šจ ๐‹ ๐ˆ ๐“‚ƒึดึถึธโ‹†.หš

Special thanks to the amazing tools, platforms, and technologies that made this project possible ๐Ÿ’–

  • ๐ŸŒธ Nekos.Best โ€” Anime image API & resources
  • ๐Ÿค– Telegram Bot API โ€” Bot interaction system
  • โ–ฒ Vercel โ€” Hosting & deployment
  • ๐Ÿ™ GitHub โ€” Version control & project management
  • ๐Ÿ’Ž Ruby โ€” Main programming language

About

Your playful Telegram AI bestie, built in Ruby, deployed on Vercel.

Topics

Resources

Stars

74 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages