README.md

metadata

title: Phone Lookup Bot
emoji: 📞
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 6.29.1
python_version: '3.12'
app_file: app.py
pinned: false
license: mit
startup_duration_timeout: 30m
short_description: Telegram phone lookup bot streaming HF dataset

📞 Phone Lookup Telegram Bot

Streams Kzr0xx/Icmr-and-hitek (104 GB) directly from HuggingFace via DuckDB. No download. No storage bucket. External heartbeat via GitHub Actions.

Required Space Secrets

Secret	Value	Required?
BOT_TOKEN	Telegram bot token from @BotFather	✅ Yes
SPACE_URL	https://<your-user>-<space-name>.hf.space	✅ Yes
WEBHOOK_SECRET	1221 (or any random string)	✅ Recommended
HF_TOKEN	HF read token	⚠️ Recommended
TELEGRAM_PROXY	Cloudflare Worker URL (see below)	❌ Only if Telegram is blocked

Endpoints

• GET /health — heartbeat / health check (used by keep-alive cron)
• POST /webhook — Telegram webhook (auto-registered on startup)
• GET / — Gradio landing page

If Telegram API Is Blocked

Some HF Space regions cannot reach api.telegram.org. If setWebhook logs show connection failures, deploy a Cloudflare Worker proxy:

1. Go to https://workers.cloudflare.com — create a free Worker
2. Paste this code:

export default {
  async fetch(request) {
    const url = new URL(request.url);
    url.hostname = "api.telegram.org";
    return fetch(new Request(url, request));
  }
};