Upload 6 files

README.md

@@ -1,6 +1,51 @@
+# Hugging Face Space Pinger Bot 🚀
+
+A Telegram bot built with **Pyrogram** and **FastAPI** to keep Hugging Face spaces alive by pinging them sequentially every 5 minutes. The database containing authorized users, admins, and space URLs is automatically created and synced to a Hugging Face dataset for persistent storage.
+
+## 🛠️ Required Secret Environment Variables
+
+When deploying this bot on Hugging Face Spaces (or any Docker platform), you **MUST** configure the following variables in the Space settings (under **Variables and Secrets**):
+
+1. **`API_ID`**: The API ID for your Telegram application (get it from [my.telegram.org](https://my.telegram.org)).
+2. **`API_HASH`**: The API Hash for your Telegram application (get it from [my.telegram.org](https://my.telegram.org)).
+3. **`BOT_TOKEN`**: The Telegram Bot Token generated by [@BotFather](https://t.me/BotFather).
+4. **`ADMIN_ID`**: The numeric Telegram ID of the **Super Admin** (e.g., `123456789`). The Super Admin has highest authority (e.g., can remove admins).
+5. **`HF_TOKEN`**: A Hugging Face User Access Token with **WRITE** permissions (generate it under your Hugging Face account settings at [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)).
+6. **`HF_DATASET_URL`**: The full URL of your Hugging Face dataset repository (e.g. `https://huggingface.co/datasets/your_username/your_dataset_name` or simply the repository ID like `your_username/your_dataset_name`). The bot will automatically create this dataset if it doesn't already exist and maintain `database.json` within it.
+
 ---
-license: apache-2.0
-title: C1
-sdk: docker
-emoji: 🏃
----
+
+## 🤖 Available Commands
+
+### 💬 Public Commands (Anyone)
+- `/id` - View your Telegram User ID (used to request authorization).
+- `/start` - Displays a simple welcome message.
+- `/help` - Explains what the bot does.
+- `/commands` - List commands matching the caller's authorization level.
+
+### 👤 Authorized User Commands
+- `/add <hf_url>` - Register a Hugging Face Space URL. (You can also just send a raw Hugging Face URL directly, and the bot will normalize and register it automatically).
+- `/remove <hf_url>` - Remove a Space URL you registered.
+- `/list_url` - List the Space URLs that *you* registered.
+
+### 👮 Admin Commands
+- `/add_user <user_id>` - Authorize a user to register and manage their own URLs.
+- `/remove_user <user_id>` - Deauthorize a user.
+- `/add_admin <user_id>` - Promote a user to Admin.
+- `/list_url` - List **ALL** registered Space URLs in the system along with who registered them.
+- `/list` - List all Admins and Users (excluding the Super Admin).
+
+### 👑 Super Admin Commands
+- `/remove_admin <user_id>` - Demote an Admin back to a regular user.
+- `/list` - List the Super Admin, all Admins, and all Users.
+
+---
+
+## 🐳 Deployment to Hugging Face Spaces
+
+1. Create a new Space on Hugging Face: [huggingface.co/new-space](https://huggingface.co/new-space).
+2. Choose **Docker** as the SDK.
+3. Select **Blank** (or any Docker template).
+4. Go to the Space **Settings** page and add the **Secrets** listed above.
+5. Push the repository files (`Dockerfile`, `requirements.txt`, `config.py`, `database.py`, `main.py`) to the Space.
+6. The space will automatically build the Docker image, run the FastAPI web server on port `7860`, launch the Telegram bot, and begin the sequential 5-minute pinger loop.

database.py

@@ -6,8 +6,10 @@ import asyncio
 from huggingface_hub import HfApi, hf_hub_download
 import config
 
+import tempfile
+
 DATA_FILE_NAME = "database.json"
-LOCAL_PATH = os.path.join(os.getcwd(), DATA_FILE_NAME)
+LOCAL_PATH = os.path.join(tempfile.gettempdir(), DATA_FILE_NAME)
 
 # In-memory database state
 db_state = {