FeiNiao Assistant · All-in-one AI Telegram Bot

About the Project

FeiNiao Assistant (@feiniaodev_bot) is an AI-powered Telegram bot for Chinese-speaking users, positioned as a "friendly AI life companion." Users can access daily fortune draws, AI copywriting, AI translation, live exchange rates, weather and almanac lookups, ambient radio, group check-in, message leaderboards, automated giveaways, and other group management tools — all without leaving Telegram. A companion Telegram Mini App (check-in calendar, badge wall, giveaway history, sticker workshop, image toolbox) syncs with the bot in real time. The bot connects to a standalone web admin panel, closing the loop from user inquiry to client management. It is also FeiNiao Dev's official traffic entry point and client acquisition channel.

Core Features

• Daily Fortune: 100 fortune sticks × 400 AI-generated readings, each covering overall luck plus four-dimensional analysis: career / relationships / finances / health
• AI Copywriting: One-tap generation for holiday greetings, social posts, short-video scripts, and more
• AI Translation: Bidirectional conversational translation, auto-detects language direction across 10 languages, conversation state persists throughout the session
• Exchange Rates: Fiat and digital assets, data refreshed every 5 minutes
• Weather: AI-generated outfit, commute, and health suggestions in one response
• Chinese Almanac + Auspicious Dates: 8 categories including wedding, business opening, and moving dates
• Ambient Radio: Relaxing music plus 6 white noise channels, playable inline
• Group Check-in: Daily clock-in with streak tracking; consecutive days unlock Bronze / Silver / Gold / Legendary badges; Mini App shows the full check-in calendar and badge wall
• Message Stats: Real-time in-group message counts, daily leaderboard refresh, Mini App shows personal data and group rankings
• Auto Giveaway: Configurable prizes and entry conditions, scheduled auto-draw, Mini App displays giveaway status and winner history
• Custom Inquiry: 3-tier entry (form / direct chat / leave contact), covering users at different decision stages
• FeiNiao Cases: Pulls from the official site's /api/cases.json to dynamically display real project work

Tech Stack

Python aiogram 3.x FastAPI PostgreSQL + Redis APScheduler Groq Llama 3.3 React 18 TypeScript Tailwind Vite Docker Cloudflare CDN

Engineering Highlights

1. Four-Tier AI Fallback Groq 70b → Groq 8b → Zhipu Flash → local rules, with automatic API key rotation. When a daily quota is exhausted, the system switches to the next key transparently. Any tier can fail without the user noticing — the bot always responds, with availability close to 100%.

2. Bidirectional Auto-Detection in Conversational Translation Built on langdetect and a conversation state machine. Once a user enters "translation mode," every subsequent message is automatically analyzed for direction and translated — no repeated language-pair switching required.

3. Three Parallel Inquiry Entry Points Form / direct chat / leave contact — three paths running in parallel, each targeting users at a different decision threshold. All inquiries are routed through the bot, and lead data flows intact into the web admin panel for tracking and follow-up.

4. Real-Time Sync Between Web Admin and Bot Welcome messages, FAQs, and holiday copy configured in the web admin take effect in the bot immediately. Leads, inquiries, and blocklist changes made through the bot are visible in the web admin in real time. FastAPI and aiogram share the same database in-process — no cross-process sync overhead.

Deliverables

• 12 user-facing features in Telegram + a complete admin menu
• Web admin with 9 management pages: dashboard / leads / broadcasts / users / automation / settings / FeiNiao cases / group management / Mini App data
• 15 holiday auto-broadcasts to the official channel (APScheduler scheduled tasks)
• Telegram Mini App covering check-in, giveaways, toolbox, and sticker workshop
• Complete client acquisition funnel: full-chain data from exposure → entry → inquiry → conversion
• Runs in a single Docker container on PostgreSQL + Redis; near-zero ongoing maintenance cost

Why It Matters

This project is FeiNiao Dev's own portfolio — proof that a small, focused team can deliver a media-grade AI Telegram bot plus web admin panel as a complete system, handling product design, engineering, and operational loop end to end.

Try it now Open FeiNiao Assistant

Want a similar system? Talk to us