Repository navigation
First public release of headless-duckapi — a self-hosted Telegram AI bot on DuckDuckGo's free duck.ai protocol.
Highlights
- Free models via duck.ai — GPT / Claude / Mistral, no API keys needed
- Pure-JS antibot browser — ~42 KB
bot/lib/duckai.jssolves duck.ai challenges (JS puzzles, V8 fingerprints) natively in Node.js — no real browser, no Playwright - Streaming answers, /img generation, photo vision
- Mini App settings per user, owner-only /stats
- Zero npm deps — SQLite is built into Node ≥ 22.5; challenge tokens & protocol counters persist in SQLite (no 418/429 re-bother after restarts)
- 3 deploy paths: bare Node.js · Docker Compose · Telegram Serverless
Install
git clone https://github.com/golaso024/headless-duckapi.git && cd headless-duckapi
npm install && cp .env.example .env # paste your @BotFather token
node app.js