How hiifyi/vps works
Project type and purpose
• This is a Telegram‑based “filter” bot (Alexa Auto Filter Bot) written in Python. It’s purely a backend service (no user‑facing web UI) that listens to Telegram updates, processes file‑related commands, enforces subscription rules, streams/downloads content, and manages state in MongoDB.
File structure
• Top‑level script files:
• bot.py / main.py / Script.py – entry points that initialize the bot client and start event listeners.
• app.py – auxiliary app (possibly a lightweight web hook or keep‑alive endpoint).
• info.py – loads ENV/config variables into the application.
• Core library (“Jisshu” package):
• Jisshu/bot/clients.py – wraps the Telegram client (Pyrogram/Telethon).
• Jisshu/server – custom server or exception handlers.
• Jisshu/util – helper routines: config parsing, download logic, template rendering, time formatting, etc.
• Jisshu/template – HTML templates for logs or responses.
• database/ – MongoDB abstraction modules (one per collection: users, chats, filters, referrals, top lists).
• plugins/ – each .py file is a feature module (commands, streaming, freesub, premium, ads, etc.).
• config/deployment files: Dockerfile, heroku.yml, Procfile, requirements.txt, runtime.txt, logging.conf.
README for additional insights
• Confirms use of MongoDB (DATABASE_URI, DATABASE_NAME).
• Requires BOT_TOKEN, API_ID/HASH (Telegram API).
• Deployable to Heroku, Render, Koyeb, or VPS.
• No mention of microservices—everything runs in one process.