README.md

metadata

title: Hotel OS Bot
emoji: 🚀
colorFrom: blue
colorTo: yellow
sdk: gradio
pinned: true
license: bigscience-openrail-m

Hotel OS Bot

A Telegram bot for managing hotel operations, including bookings, payments, and expenses.

Project Structure

hotel_os_bot/
├── app/
│   ├── __init__.py
│   ├── main.py           # Bot + FastAPI + Polling
│   ├── utils.py          # OCR, Verify, DB helpers
│   └── resources/
│       └── pms_blueprint.txt
├── webapp/
│   ├── index.html
│   ├── style.css
│   └── app.js
├── scripts/
│   ├── backup_db.py
│   └── notify_pending.py
├── data/
├── requirements.txt
├── Dockerfile
├── .dockerignore
├── start.sh
├── space.yaml
├── .env.example
└── README.md

How to Run

1. Set up the environment:

   cp .env.example .env
   

   Then, edit the .env file with your actual credentials (Telegram Bot Token, User ID, Gemini API Key).

2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the application:

   chmod +x start.sh
   ./start.sh
   

   Alternatively, you can run the main module directly:

   python -m app.main
   

Deploy to Hugging Face Spaces

1. Push the code to a GitHub repository.
2. Create a new Space on Hugging Face, selecting the "Docker" runtime.
3. Connect the Space to your GitHub repository.
4. In the Space settings, add the secrets from your .env file (TELEGRAM_BOT_TOKEN, TELEGRAM_USER_ID, GEMINI_API_KEY).