| title | tg-bot-cocoa |
|---|---|
| emoji | 🤖 |
| colorFrom | blue |
| colorTo | purple |
| sdk | docker |
| app_port | 7860 |
AI processor untuk Telegram bot. Menerima request dari Cloudflare Worker, menjalankan agent loop dengan Gemini/Groq, dan mengembalikan hasil.
Repo & Space ini publik, jadi semua secret hanya boleh lewat env.
RUNNER_SECRET (acak, min 16 karakter) diset di GitHub Secrets dan Vercel;
workflow deploy menyebarkannya otomatis ke Cloudflare Worker & HF Space:
S=$(openssl rand -hex 32)
gh secret set RUNNER_SECRET --body "$S"
printf %s "$S" | npx vercel env add RUNNER_SECRET production --force
npx vercel deploy --prod # env Vercel baru terbaca setelah deploy ulangKey provider (Gemini, Cerebras, dll) cukup ada di Cloudflare Worker: Worker meneruskannya
ke Vercel per job lewat kanal ber-auth RUNNER_SECRET, jadi Vercel tidak perlu menyimpannya.
Urutan dicoba sesuai AI_PROVIDERS (wrangler.jsonc); provider tanpa key dilewati.
| Provider | Cara aktifkan |
|---|---|
| Gemini | GEMINI_API_KEYS |
| Cerebras (~1 juta token/hari gratis) | npx wrangler secret put CEREBRAS_API_KEY (+ HF secret yang sama) |
OpenRouter (model :free) |
OPENROUTER_API_KEY |
| Groq | GROQ_API_KEY + GROQ_ENABLED=true |
| Cloudflare Workers AI (10rb neuron/hari) | otomatis di Worker (binding AI); di Spaces butuh CF_ACCOUNT_ID + CF_AI_TOKEN |
Opsional tapi disarankan, verifikasi webhook Telegram:
TG_SECRET=$(openssl rand -hex 32)
echo "$TG_SECRET" | npx wrangler secret put TELEGRAM_WEBHOOK_SECRET
curl -s "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
-d url=https://tg-bot.thirapi.workers.dev/ -d secret_token="$TG_SECRET"npm testDeploy (.github/workflows/deploy.yml) hanya jalan kalau test lulus.