README.md

---
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:**
    ```bash
    cp .env.example .env
    ```
    Then, edit the `.env` file with your actual credentials (Telegram Bot Token, User ID, Gemini API Key).

2.  **Install dependencies:**
    ```bash
    pip install -r requirements.txt
    ```

3.  **Run the application:**
    ```bash
    chmod +x start.sh
    ./start.sh
    ```
    Alternatively, you can run the main module directly:
    ```bash
    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`).