Your all-in-one self-hosted automation platform.
Bots Β· Cloud Storage Β· Automation Β· Scrapers Β· AI Agents β all in one dashboard.
Vinnoflow is a modular, self-hosted platform designed to be the command center for builders.
Instead of juggling 10 different tools β a cloud service, a bot host, a scraper runner, an automation platform β Vinnoflow brings them all under one beautiful dashboard.
Zero config files. Everything set up from your browser.
Vinnoflow is built as a modular platform. Each module is independent β enable only what you need.
| Module | Status | Description |
|---|---|---|
| βοΈ Cloud Storage | β Live (v1) | Telegram-powered unlimited storage with web UI |
| π€ Bot Templates | π§ Coming Soon | Deploy pre-built Telegram bots in one click |
| β‘ Automation Flows | π§ Coming Soon | Visual workflow builder (like Zapier / n8n) |
| π·οΈ Web Scrapers | ποΈ Planned | Scheduled scrapers with data export |
| π§ AI Agents | ποΈ Planned | Chat agents, task agents, autonomous bots |
| π Credential Vault | ποΈ Planned | Secure storage for API keys and secrets |
The first module of Vinnoflow lets you turn Telegram into your personal cloud drive.
- π Clean, mobile-friendly dashboard
- βοΈ Unlimited free storage via Telegram
- π€ Upload files up to 2 GB with live progress
- π₯ In-browser video streaming with seek
- π Public share links β no login required to view
- π Nested folders, rename, move, delete
- π€ Upload via Telegram bot (DM or channel post)
- π Secure login (bcrypt hashed passwords, session auth)
- βοΈ Zero config files β full setup through browser wizard
git clone https://github.com/shivamnox/Vinnoflow.git
cd Vinnoflow
npm install && npm startThen open http://localhost:3000 and follow the setup wizard π
Free MongoDB in 2 minutes at MongoDB Atlas β paste URI β connect.
Email + password (8+ chars).
Avatar (optional) + display name β Done!
Click the Cloud Storage card on the dashboard. Fill 5 fields:
| Field | Where to Get |
|---|---|
| API ID & API Hash | my.telegram.org β API Development Tools |
| Bot Token | @BotFather β /newbot |
| DB Channel ID | Create private channel β add bot as admin β forward a message to @userinfobot |
| Owner Telegram ID | Send /start to @userinfobot |
β οΈ Important: Bot must be admin in your DB Channel β otherwise uploads will fail.
Click Save & Connect β wait 15-40 seconds β done β
| Action | How |
|---|---|
| Upload file | Open folder β Upload button |
| Share file | 3-dot menu β Share β copy public link |
| Stream video | Just click any video |
| Bot upload | DM bot any file OR post in DB channel |
| Organize | Right-click / 3-dot menu on any item |
| Command | Purpose |
|---|---|
/start |
Start the bot |
/settings |
Link channels to folders |
/addf |
Set default folder |
/activeinfo |
Show active channel mappings |
/clearactive |
Remove a channel mapping |
- Telegram-powered file storage
- Web dashboard, video streaming, share links
- Bot integration
- One-click deploy for popular Telegram bots
- Manage multiple bots from single dashboard
- Bot analytics and logs
- Visual workflow builder
- Connect apps and services
- Scheduled and event-driven triggers
- Web scrapers with scheduling
- AI agents and autonomous bots
- Credential vault for secure API storage
- Plugin system for community modules
Follow releases to stay updated.
Vinnoflow works on any Node.js host:
- Replit β click Run
- Railway β free credits
- Render β free tier available
- VPS β use
pm2for persistence
npm install -g pm2
pm2 start index.js --name vinnoflow
pm2 save && pm2 startup- Node.js + Express β backend
- MongoDB (Mongoose) β database
- GramJS (MTProto) β Telegram large file transfers
- node-telegram-bot-api β bot commands
- bcrypt β password hashing
- Plyr.js β video player
- Multer β file upload handling
| Problem | Fix |
|---|---|
| Uploads fail with "Cloud not connected" | Profile β Reconnect Cloud |
| Bot not saving channel files | Ensure bot is admin in that channel |
| Setup wizard reappears after restart | Check .env file permissions |
| Port already in use | Run PORT=4000 npm start |
Vinnoflow is designed to be modular and extensible. Contributions are welcome for:
- New modules (bots, scrapers, agents)
- UI/UX improvements
- Bug fixes and documentation
- Deployment guides for new platforms
See CONTRIBUTING.md for guidelines.
MIT β free to use, modify, and share.
If Vinnoflow helped you, please star the repo β
Every star helps more builders discover the project.