Skip to content
/ Lunchy Public

The smart AI agent that intelligently selects one person from the chat group participants based on custom criteria — perfect for deciding who’s ordering lunch

Notifications You must be signed in to change notification settings

mhewedy/Lunchy

Repository files navigation

Lunchy

Lunchy is a smart AI-powered Telegram bot designed to fairly and intelligently choose one person from a chat group to be responsible for ordering lunch. Whether you're tired of the same person ordering every day, or you just want to make lunch assignments more fun, Lunchy has your back.

Built with modular components and optional AI integration (via Google Gemini or ChatGPT), Lunchy uses natural language detection to identify food-related conversations and trigger a fair selection process based on configurable criteria.

Usage

If you want to use the bot, go and create a telegram group, add the bot to it and make him admin. The bot is deployed under the name @Lunchy_funchy_bot

If you prefer to deploy it yourself, follow the instructions below.

Deployment

  1. Create a bot using telegram @BotFather see How to get Telegram Bot Chat ID.
  2. Create a telegram group, add the bot to the group, and make it admin.
  3. Set the env var BOT_TOKEN.
  4. if you want to use Google Gemini AI, then obtain and set GEMINI_API_KEY
  5. Optionally, if you need to persist the data between restarts, configure VOLUME_ROOT_FS to point to path of some persistent volume (block or network storage).
  6. Run the app using BOT_TOKEN=<bot_token> python main.py
  7. Start sending commands in the group (e.g. /help), the bot will detect food names as well (using Gemini).
  8. Enjoy!

This app is built using telebot

About

The smart AI agent that intelligently selects one person from the chat group participants based on custom criteria — perfect for deciding who’s ordering lunch

Resources

Stars

Watchers

Forks

Languages