Hysen LabsFree-Telegram-Store-Bot
This is 100% Free Shop Bot, Is a Telegram Store Bot you can use for selling your products and services and managing your products and orders. You customers can easily use the Auto Buy Bot to shop on you store with confidence using this Auto shop bot.
Free Telegram Store Bot turns a chat into a digital goods shop
A self hosted Telegram bot that sells license keys and file downloads, settles payments in crypto or by card, and delivers them automatically.
What the bot does
Free Telegram Store Bot is a Python application that runs inside Telegram and handles the full cycle of selling digital products. Customers browse a catalog organized into categories and subcategories, then top up an internal wallet and spend that balance on items. Two product types are supported: license keys that are pulled automatically from an inventory table, and downloadable files that are delivered through generated links. A complete admin panel lives inside the chat and covers products, categories, stock and restock, orders, disputes, user bans and unbans, broadcast messages, and store settings. The project is built with python-telegram-bot version 20 in its async mode and uses SQLAlchemy 2.0 over a SQLite database by default, with PostgreSQL as an option.
How payments are handled
Two top up methods are included, and each can be switched on or off independently through configuration. CryptoBot lets buyers pay with any cryptocurrency through the @CryptoBot Telegram account, while the card method uses native in-Telegram card checkout provided by Telegram Payments. Money lands in the customer wallet, and purchases draw from that balance rather than charging per transaction. Background jobs run payment verification and periodic availability broadcasts so that stock and listings stay current without manual intervention. Because settlement happens through external payment providers, the operator is responsible for the accounts and webhooks those services require.
Running and deploying it
The repository documents a straightforward setup path: Python 3.10 or newer, a clone of the repo, a virtual environment, dependency installation, environment variable configuration, and running bot.py. That single file is the wiring point, validating the config directory, initializing the database layer, and registering all handlers before the bot starts. Handlers talk to Telegram, call into a services directory for external APIs, and rely on a utils directory for keyboards and helpers, while every database call goes through a shared get_db_session helper. Store operators reach the customer view with /start and the control panel with /admin. The code is released under the MIT license, and the August 2026 snapshot shows 153 stars and 91 forks.
Editorial conclusion
The project is distributed under the MIT license and targets Python 3.10 or newer. Its repository records 153 stars and 91 forks as of the August 2026 snapshot, and the bot is organized around a single bot.py entry point that wires configuration, database, and handlers together.
Community notes