AiogramShopBot

🛍️ Production-style Telegram shop bot with crypto payments, admin flows, FastAPI webhooks, and multibot support.

AiogramShopBot is an open source Telegram shop bot built with Aiogram 3, FastAPI, SQLAlchemy async, PostgreSQL, Redis, Docker Compose, and SQLAdmin. It helps you sell digital goods and physical goods inside Telegram with built-in cryptocurrency payments, shopping cart, purchase history, admin tools, shipping, reviews, coupons, analytics, referrals, and multi-language support.

This repository is designed for developers and product teams who need a production-style Telegram ecommerce bot with a web admin panel, payment processing, localization, and scalable deployment.

✨ Why This Project

• Sell digital and physical products directly in Telegram.
• Accept crypto top-ups with Bitcoin, Dogecoin, Litecoin, Solana, Ethereum, Binance Coin, USDT, and USDC networks.
• Manage inventory, users, coupons, shipping, reviews, media, and purchases from Telegram admin flows.
• Use PostgreSQL, Redis, webhook mode, and Docker-based deployment for production setups.
• Extend the project with FastAPI routes, SQLAdmin, repositories, services, and Aiogram handlers.

🚀 Core Features

• Telegram storefront with categories, subcategories, cart, checkout, and purchase history.
• Admin menu for announcements, inventory, user management, analytics, wallet operations, media, coupons, shipping, buys, and reviews.
• Crypto payment integration with KryptoExpress.
• Referral system with limits and anti-abuse rules.
• Localization through JSON translation files.
• SQLAdmin web panel for database objects.
• Docker Compose setup for local and production-like environments.
• Multibot mode with one main bot and managed child bots.

🧰 Tech Stack

• Python 3.12
• Aiogram 3
• FastAPI
• SQLAlchemy async
• PostgreSQL
• Redis
• Alembic
• SQLAdmin
• Docker Compose

⚡ Quick Start

🖥️ Interactive deployment

Run the installer script on your VPS:

sudo sh -c "$(curl -fsSL https://raw.githubusercontent.com/ilyarolf/AiogramShopBot/refs/heads/master/scripts/deploy.sh)"

💻 Local development

git clone https://github.com/ilyarolf/AiogramShopBot.git
cd AiogramShopBot
pip install -r requirements.txt
python run.py

You will also need PostgreSQL, Redis, environment variables, and webhook/reverse proxy configuration.

Full setup guide:

• Deployment and environment variables
• Local run example

🎬 Product Walkthrough

💳 User balance top-up

🛒 Product purchase flow

🧾 Purchase history

👛 Admin wallet withdrawal

More Telegram bot GIF demos, admin flow examples, and screenshots are available in docs.md.

📚 Documentation

• Full documentation
• Deployment and configuration
• User manual
• Admin manual
• Referral system
• Cryptocurrency forwarding
• SQLAdmin panel
• Multibot mode

🌍 Community

• Contributing guide
• Code of Conduct
• Security policy
• Support

🎯 Use Cases

• Telegram shop bot for digital products
• Telegram bot for physical goods with shipping
• Crypto-funded Telegram marketplace
• Telegram multibot commerce setup with one manager bot
• Aiogram ecommerce starter project
• FastAPI + Aiogram + SQLAlchemy production template
• Telegram admin panel and back office automation

🤝 Commercial Contact

• Demo bot: @demo_aiogramshopbot
• Commercial requests: @ilyarolf_dev

💖 Donate

• BTC: bc1q2kv89q8yvf068xxw3x65gzfag98l9wnrda3x56
• DOGE: D8BFXqDM7MHf3A4j3kC8wWEN8DqRLVQjax
• LTC: ltc1q0tuvm5vqn9le5zmhvhtp7z9p2eu6yvv24ey686
• SOL: Avm7VAqPrwpHteXKfDTRFjpj6swEzjmj3a2KQvVDvugK
• ETH: 0xB49D720DE2630fA4C813d5B4c025706E25cF74fe
• TON: UQD0QetwXoYTsmbZWVbE_z_JUFh54RVVRUxCbCHQkLsl3Hfn
• USDT ERC20: 0xB49D720DE2630fA4C813d5B4c025706E25cF74fe
• USDT BEP20: 0xB49D720DE2630fA4C813d5B4c025706E25cF74fe

⭐ Star History

📄 License

MIT License