{"id":47699101,"url":"https://github.com/ilyarolf/AiogramShopBot","last_synced_at":"2026-04-17T19:00:46.819Z","repository":{"id":168804632,"uuid":"611324299","full_name":"ilyarolf/AiogramShopBot","owner":"ilyarolf","description":"Open-source Telegram e-commerce bot built with Aiogram 3 for selling digital and physical goods with crypto payments and referral system.","archived":false,"fork":false,"pushed_at":"2026-04-14T22:08:39.000Z","size":1204,"stargazers_count":167,"open_issues_count":1,"forks_count":60,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-04-14T23:17:37.495Z","etag":null,"topics":["aiogram3","binance-coin","bitcoin","cryptocurrency","ethereum","litecoin","postsgresql","shop","solana","sqladmin","sqlalchemy","store","telegram","telegram-ecommerce","telegram-shop","telegram-store","tether","usd-coin","usdc","usdt"],"latest_commit_sha":null,"homepage":"https://t.me/demo_aiogramshopbot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ilyarolf.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-08T15:36:50.000Z","updated_at":"2026-04-14T22:08:10.000Z","dependencies_parsed_at":"2023-10-03T01:49:18.031Z","dependency_job_id":"d3eb22a2-e0e6-4ad3-b00b-4874990e30d3","html_url":"https://github.com/ilyarolf/AiogramShopBot","commit_stats":null,"previous_names":["ilyarolf/aiogramshopbot"],"tags_count":43,"template":false,"template_full_name":null,"purl":"pkg:github/ilyarolf/AiogramShopBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyarolf%2FAiogramShopBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyarolf%2FAiogramShopBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyarolf%2FAiogramShopBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyarolf%2FAiogramShopBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ilyarolf","download_url":"https://codeload.github.com/ilyarolf/AiogramShopBot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyarolf%2FAiogramShopBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31941845,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiogram3","binance-coin","bitcoin","cryptocurrency","ethereum","litecoin","postsgresql","shop","solana","sqladmin","sqlalchemy","store","telegram","telegram-ecommerce","telegram-shop","telegram-store","tether","usd-coin","usdc","usdt"],"created_at":"2026-04-02T17:00:46.815Z","updated_at":"2026-04-17T19:00:46.812Z","avatar_url":"https://github.com/ilyarolf.png","language":"Python","funding_links":[],"categories":["OpenSource"],"sub_categories":["OpenSource Bots"],"readme":"\u003ch1 align=\"center\"\u003eAiogramShopBot\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🛍️ Production-style Telegram shop bot with crypto payments, admin flows, FastAPI webhooks, and multibot support.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://t.me/demo_aiogramshopbot\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Live_Demo_Bot-blue?logo=probot\u0026logoColor=white\" alt=\"Live bot\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://t.me/ilyarolf_dev\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Contact_me-blue?logo=telegram\u0026logoColor=white\" alt=\"Business offer\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n[![Python](https://img.shields.io/badge/Python_3.12-3776AB?logo=python\u0026logoColor=%23fff)](https://www.python.org/downloads/release/python-3127/)\n[![Dockerhub](https://img.shields.io/badge/Docker_Hub-2496ED?logo=docker\u0026logoColor=fff)](https://hub.docker.com/r/ilyarolf/aiogram-shop-bot)\n[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-316192?logo=postgresql\u0026logoColor=white)](https://www.sqlite.org/)\n[![Bitcoin](https://img.shields.io/badge/Bitcoin-FF9900?logo=bitcoin\u0026logoColor=white)](https://github.com/bitcoin/bitcoin)\n[![Dogecoin](https://img.shields.io/badge/Dogecoin-C2A633?logo=dogecoin\u0026logoColor=white)](https://dogecoin.com/)\n[![Litecoin](https://img.shields.io/badge/Litecoin-A6A9AA?logo=litecoin\u0026logoColor=white)](https://github.com/litecoin-project/litecoin)\n[![Solana](https://img.shields.io/badge/Solana-9945FF?logo=solana\u0026logoColor=fff)](https://github.com/solana-labs/solana)\n[![Ethereum](https://img.shields.io/badge/Ethereum-3C3C3D?logo=ethereum\u0026logoColor=white)](https://github.com/ethereum)\n[![BinanceCoin](https://img.shields.io/badge/Binance-FCD535?logo=binance\u0026logoColor=000)](https://github.com/binance)\n[![Tether](https://img.shields.io/badge/Tether-168363?\u0026logo=tether\u0026logoColor=white)](https://tether.to/)\n[![USD Coin](https://img.shields.io/badge/USD%20Coin-2775CA?\u0026logo=usd-coin\u0026logoColor=white)](https://www.usdc.com/)\n\n**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**.\n\nThis 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.\n\n## ✨ Why This Project\n\n- Sell digital and physical products directly in Telegram.\n- Accept crypto top-ups with Bitcoin, Dogecoin, Litecoin, Solana, Ethereum, Binance Coin, USDT, and USDC networks.\n- Manage inventory, users, coupons, shipping, reviews, media, and purchases from Telegram admin flows.\n- Use PostgreSQL, Redis, webhook mode, and Docker-based deployment for production setups.\n- Extend the project with FastAPI routes, SQLAdmin, repositories, services, and Aiogram handlers.\n\n## 🚀 Core Features\n\n- Telegram storefront with categories, subcategories, cart, checkout, and purchase history.\n- Admin menu for announcements, inventory, user management, analytics, wallet operations, media, coupons, shipping, buys, and reviews.\n- Crypto payment integration with KryptoExpress.\n- Referral system with limits and anti-abuse rules.\n- Localization through JSON translation files.\n- SQLAdmin web panel for database objects.\n- Docker Compose setup for local and production-like environments.\n- Multibot mode with one main bot and managed child bots.\n\n## 🧰 Tech Stack\n\n- Python 3.12\n- Aiogram 3\n- FastAPI\n- SQLAlchemy async\n- PostgreSQL\n- Redis\n- Alembic\n- SQLAdmin\n- Docker Compose\n\n## ⚡ Quick Start\n\n### 🖥️ Interactive deployment\n\nRun the installer script on your VPS:\n\n```bash\nsudo sh -c \"$(curl -fsSL https://raw.githubusercontent.com/ilyarolf/AiogramShopBot/refs/heads/master/scripts/deploy.sh)\"\n```\n\n### 💻 Local development\n\n```bash\ngit clone https://github.com/ilyarolf/AiogramShopBot.git\ncd AiogramShopBot\npip install -r requirements.txt\npython run.py\n```\n\nYou will also need PostgreSQL, Redis, environment variables, and webhook/reverse proxy configuration.\n\nFull setup guide:\n- [Deployment and environment variables](docs.md#deployment-and-configuration)\n- [Local run example](docs.md#local-development-example)\n\n## 🎬 Product Walkthrough\n\n### 💳 User balance top-up\n\n![Top Up Balance Demo](https://i.imgur.com/j2l7fHc.gif)\n\n### 🛒 Product purchase flow\n\n![Purchase Flow Demo](https://i.imgur.com/yEUw32h.gif)\n\n### 🧾 Purchase history\n\n![Purchase History Demo](https://i.imgur.com/t5sA38N.gif)\n\n### 👛 Admin wallet withdrawal\n\n![Wallet Demo](https://i.imgur.com/gjkRFVb.gif)\n\nMore Telegram bot GIF demos, admin flow examples, and screenshots are available in [docs.md](docs.md#demo-gallery).\n\n## 📚 Documentation\n\n- [Full documentation](docs.md)\n- [Deployment and configuration](docs.md#deployment-and-configuration)\n- [User manual](docs.md#user-manual)\n- [Admin manual](docs.md#admin-manual)\n- [Referral system](docs.md#referral-system)\n- [Cryptocurrency forwarding](docs.md#cryptocurrency-forwarding)\n- [SQLAdmin panel](docs.md#sqladmin-web-admin-panel)\n- [Multibot mode](docs.md#multibot-experimental)\n\n## 🌍 Community\n\n- [Contributing guide](CONTRIBUTING.md)\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [Security policy](SECURITY.md)\n- [Support](SUPPORT.md)\n\n## 🎯 Use Cases\n\n- Telegram shop bot for digital products\n- Telegram bot for physical goods with shipping\n- Crypto-funded Telegram marketplace\n- Telegram multibot commerce setup with one manager bot\n- Aiogram ecommerce starter project\n- FastAPI + Aiogram + SQLAlchemy production template\n- Telegram admin panel and back office automation\n\n## 🤝 Commercial Contact\n\n- Demo bot: [@demo_aiogramshopbot](https://t.me/demo_aiogramshopbot)\n- Commercial requests: [@ilyarolf_dev](https://t.me/ilyarolf_dev)\n\n## 💖 Donate\n\n- BTC: `bc1q2kv89q8yvf068xxw3x65gzfag98l9wnrda3x56`\n- DOGE: `D8BFXqDM7MHf3A4j3kC8wWEN8DqRLVQjax`\n- LTC: `ltc1q0tuvm5vqn9le5zmhvhtp7z9p2eu6yvv24ey686`\n- SOL: `Avm7VAqPrwpHteXKfDTRFjpj6swEzjmj3a2KQvVDvugK`\n- ETH: `0xB49D720DE2630fA4C813d5B4c025706E25cF74fe`\n- TON: `UQD0QetwXoYTsmbZWVbE_z_JUFh54RVVRUxCbCHQkLsl3Hfn`\n- USDT ERC20: `0xB49D720DE2630fA4C813d5B4c025706E25cF74fe`\n- USDT BEP20: `0xB49D720DE2630fA4C813d5B4c025706E25cF74fe`\n\n## ⭐ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=ilyarolf/AiogramShopBot\u0026type=Date)](https://star-history.com/#ilyarolf/AiogramShopBot\u0026Date)\n\n## 📄 License\n\n[MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filyarolf%2FAiogramShopBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Filyarolf%2FAiogramShopBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filyarolf%2FAiogramShopBot/lists"}