Skip to content

Latest commit

Β 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌊 Vinnoflow

Your all-in-one self-hosted automation platform.

Bots Β· Cloud Storage Β· Automation Β· Scrapers Β· AI Agents β€” all in one dashboard.

Version License Node Stars


🎯 What is Vinnoflow?

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.


🧩 Modules

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

✨ Current Release β€” v1.0 (Cloud Storage)

The first module of Vinnoflow lets you turn Telegram into your personal cloud drive.

Features

  • 🌐 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

πŸš€ Quick Start

git clone https://github.com/shivamnox/Vinnoflow.git
cd Vinnoflow
npm install && npm start

Then open http://localhost:3000 and follow the setup wizard πŸŽ‰


πŸ“ Setup β€” 3 Simple Screens

1️⃣ Connect Database

Free MongoDB in 2 minutes at MongoDB Atlas β†’ paste URI β†’ connect.

2️⃣ Create Admin Login

Email + password (8+ chars).

3️⃣ Set Up Profile

Avatar (optional) + display name β†’ Done!


☁️ Enable Cloud Storage Module

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 βœ…


🎯 Using Cloud Storage

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

πŸ€– Bot Commands

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

πŸ—ΊοΈ Roadmap

v1.0 β€” Cloud Storage βœ… (Current)

  • Telegram-powered file storage
  • Web dashboard, video streaming, share links
  • Bot integration

v1.1 β€” Bot Templates 🚧

  • One-click deploy for popular Telegram bots
  • Manage multiple bots from single dashboard
  • Bot analytics and logs

v1.2 β€” Automation Flows 🚧

  • Visual workflow builder
  • Connect apps and services
  • Scheduled and event-driven triggers

v2.0 β€” Full Platform πŸ—“οΈ

  • 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.


🌐 Deploy Online

Vinnoflow works on any Node.js host:

  • Replit β€” click Run
  • Railway β€” free credits
  • Render β€” free tier available
  • VPS β€” use pm2 for persistence
npm install -g pm2
pm2 start index.js --name vinnoflow
pm2 save && pm2 startup

πŸ› οΈ Tech Stack

  • 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

❓ Troubleshooting

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

🀝 Contributing

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.


πŸ“„ License

MIT β€” free to use, modify, and share.


⭐ Support the Project

If Vinnoflow helped you, please star the repo ⭐
Every star helps more builders discover the project.


Vinnoflow β€” Built with ❀️ by ShivamNox

Part of the Vinnoshiv product suite

One dashboard. Every tool. Total control.

About

🌊 All-in-one self-hosted automation platform β€” bots, cloud storage, workflows, scrapers & AI agents in one dashboard. v1: Telegram-powered unlimited cloud storage with zero config.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages