Spaces:
Sleeping
Sleeping
| title: JARVIS Telegram Bot | |
| emoji: 🤖 | |
| colorFrom: indigo | |
| colorTo: purple | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| # J.A.R.V.I.S. — Telegram Bot (Hugging Face primary, no Render) | |
| Polls `@AyomideJarvis_bot` and replies via the Muse Spark brain, with Firebase | |
| memory/notes/reminders and PC-task queueing. All Telegram traffic goes through | |
| `telegram_transport.py` (direct or via the Cloudflare relay). | |
| ## Space Secrets (Settings → Variables and secrets) — exact list | |
| | Secret | Required | Value | | |
| |---|---|---| | |
| | `TELEGRAM_BOT_TOKEN` | yes | Bot token from @BotFather (no quotes) | | |
| | `OPENCODE_API_KEY` | yes | Muse Spark / OpenCode Zen key | | |
| | `OPENCODE_MODEL` | yes | `muse-spark-1.3-contributor-free` | | |
| | `FIREBASE_CREDENTIALS_JSON` | yes | Full service-account JSON (one line) | | |
| | `JARVIS_TG_UID` | optional | Your Telegram numeric ID (blank = open) | | |
| | `TELEGRAM_TRANSPORT` | yes | `auto` (start here), then `proxy` once relay is tested | | |
| | `TELEGRAM_PROXY_URL` | for proxy | `https://jarvis-tg-relay.<you>.workers.dev` | | |
| | `TELEGRAM_PROXY_AUTH` | for proxy | Same secret as Worker `TELEGRAM_RELAY_SECRET` | | |
| | `N8N_REMINDER_WEBHOOK` | optional | n8n webhook for reminder fan-out | | |
| | `TELEGRAM_MODE` | optional | `polling` (default) or `webhook` | | |
| | `SPACE_PUBLIC_URL` | webhook only | `https://<space>.hf.space` | | |
| | `TELEGRAM_WEBHOOK_SECRET` | webhook only | Long random string (also given to Telegram) | | |
| No secrets in source code — the bot exits with `TELEGRAM_NO_TOKEN` if the token is missing. | |
| ## Files in this folder (deployed to the Space root) | |
| - `app.py` — entrypoint (`CMD python app.py`) | |
| - `telegram_bot.py` — canonical bot (brain, Firebase, queue, webhook/polling) | |
| - `telegram_transport.py` — direct/proxy transport + `/diag` matrix | |
| - `requirements.txt`, `Dockerfile`, `README.md` | |
| ## Endpoints (`:7860`) | |
| - `/` — health: model, mode, transport, polls, offset, Telegram reachability | |
| - `/diag` — network test matrix JSON (DNS/TCP/HTTPS/getMe direct-vs-proxy, no secrets) | |
| - `/webhook/<secret>` — Telegram webhook receiver (webhook mode only) | |