Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
146 changes: 112 additions & 34 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,56 +1,134 @@
# Free-Telegram-Store-Bot
I made this Bot Free 100%.
# Free Telegram Store Bot πŸ€–

The Telegram Store Bot you can use for selling and managing your products, services, and orders.
> πŸ›’ A 100% free Telegram bot for selling products and managing orders

![image1](https://i.ibb.co/6tvrHzH/v5-1.png)
A complete Telegram store solution for selling products and services. No fees, no subscriptions β€” just a powerful bot that handles your entire e-commerce workflow.

[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Telegram](https://img.shields.io/badge/Telegram-Bot-blue)](https://t.me)

# Message me at [@InDMDev](https://t.me/InDMDev) for your advanced Bots customizations.
## ✨ Features

- πŸ›οΈ **Product Management** β€” Add, edit, remove products easily
- πŸ’³ **Order Processing** β€” Automated order workflow
- πŸ“¦ **Inventory Tracking** β€” Real-time stock management
- πŸ’¬ **Customer Chat** β€” Direct messaging with buyers
- πŸ“Š **Sales Dashboard** β€” Track orders and revenue
- 🌐 **Multi-currency** β€” Support for various currencies

For more Bots like this, and to be the first to know when I publish free bots, join my channel: [@InDMDevBots](https://t.me/InDMDevBots)
## πŸš€ Quick Start

### Prerequisites

# Guide
1. Install Python 3.10
2. Install any git version
3. Open terminal
4. Run this command in your terminal "git clone https://github.com/indmdev/Free-Telegram-Store-Bot.git"
5. Run this command in your terminal "cd Free-Telegram-Store-Bot-main"
6. Run this command in your terminal: "pip install -r requirements.txt"
7. Set up a free NGROK account at https://ngrok.com
8. Open another terminal and run your Ngrok
9. Setup your new Bot at [@BotFather](https://t.me/Botfather)
10. Open the config.env file
11. Add your Bot Token (Provided to you by [@BotFather](https://t.me/Botfather))
12. Add your Ngrok URL
13. Add your Store Currency
14. Save and close the file
16. Run the "python store_main.py" command in your terminal from the "Free-Telegram-Store-Bot-main" folder
17. Completed
- Python 3.10+
- Telegram Bot Token (from [@BotFather](https://t.me/Botfather))
- Ngrok account (for local development)

### Installation

```bash
# 1. Clone the repository
git clone https://github.com/indmdev/Free-Telegram-Store-Bot.git
cd Free-Telegram-Store-Bot

# Upgraded version of this FREE Bot πŸ‘‰: [@InDMShopV5Bot](https://t.me/inDMShopV5Bot)
# 2. Install dependencies
pip install -r requirements.txt

# [Our Classic Bot Features:](https://i.ibb.co/6tvrHzH/v5-1.png)
# 3. Configure environment
cp config.env.example config.env

# Test and Subscribe To Classic Bot πŸ‘‰ [@InDMShopBot](https://t.me/InDMShopBot) [Check Demo](https://t.me/InDMMarketbot)
# 4. Edit config.env with your settings
# - Add your Telegram Bot Token
# - Add your Ngrok URL
# - Set your store currency

# 5. Run the bot
python store_main.py
```

### Setup with Ngrok (Local Development)

# Version 6 coming soon πŸ‘‡:
![photo_2025-09-10 08 21 53](https://i.ibb.co/8mhDS9F/v5-2.png)
```bash
# 1. Sign up at https://ngrok.com and get your auth token

# Languages in version 6 coming soon πŸ‘‡:
![photo_2025-09-10 08 21 53](https://i.ibb.co/d54nQJ7/v5-3.png)
# 2. Start Ngrok
ngrok http 5000

# 3. Copy the forwarding URL to your config.env

# 4. Set up your bot with @BotFather
# - Create a new bot
# - Copy the API token to config.env
```

🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
# Note: Use this program only for legal purposes, InDMDev is not and will not be responsible for any illegal activity/activities you indulge in using this program.
🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
## πŸ“± Demo

Test the bot directly:

# MAKE THE WORLD A BETTER PLACE πŸ™
| Version | Link | Description |
|---------|------|-------------|
| **Latest** | [@InDMShopV5Bot](https://t.me/InDMShopV5Bot) | New version with all features |
| **Classic** | [@InDMShopBot](https://t.me/InDMShopBot) | Original version |

## πŸ“Έ Screenshots

![Interface](https://i.ibb.co/6tvrHzH/v5-1.png)

## πŸ› οΈ Bot Commands

| Command | Description |
|---------|-------------|
| `/start` | Start the store bot |
| `/products` | Browse available products |
| `/orders` | View your orders |
| `/cart` | View shopping cart |
| `/help` | Get help with commands |

## βš™οΈ Configuration

Edit `config.env`:

```env
BOT_TOKEN=your_telegram_bot_token
NGROK_URL=https://your-ngrok-url.ngrok.io
CURRENCY=USD
ADMIN_ID=your_telegram_user_id
```

## πŸ”§ API Reference

### Bot Methods

```
store_main.py
β”œβ”€β”€ handle_start() # Initialize bot
β”œβ”€β”€ handle_products() # List products
β”œβ”€β”€ handle_order() # Process order
└── handle_payment() # Handle payments
```

## 🀝 Contributing

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## πŸ“’ Stay Updated

- [Telegram Channel](https://t.me/InDMDevBots) β€” Get notified about new releases
- [Contact Developer](https://t.me/InDMDev) β€” Custom bot development

## ⚠️ Disclaimer

Use this program only for legal purposes. The developer is not responsible for any illegal activity.

## πŸ“„ License

This project is MIT License β€” see the [LICENSE](LICENSE) file for details.

---

*README optimized with [Gingiris README Generator](https://gingiris.github.io/github-readme-generator/)*