🇷🇺 Перейти на русскую версию

🫖 "NeChainik" — E-Commerce Telegram Catalog Bot

A lightweight, zero-database Telegram e-commerce catalog bot built with Kurigram (Pyrogram fork) for a specialized tea, coffee, and Asian street food store.

💼 Commercial Project Showcase: The bot was developed in 2025 to order for a real business.The bot was developed in 2025 to order for a real business. The business has since concluded operations, and the codebase is published as a portfolio item.

---

🌟 Key Features

• Zero-DBMS Data Architecture: The entire product catalog (categories, subcategories, items, descriptions, and media paths) is structured in Python dictionaries (assortment.py). This eliminates database deployment overhead while ensuring instant response times.
• Hybrid Navigation Interface:
  • Main Categories: Fast selection via persistent ReplyKeyboardMarkup.
  • Subcategories & Products: Interactive InlineKeyboardMarkup navigation.
• Smart Pagination: Automatic 10-item-per-page chunking with dynamic Previous / Next page controls and page index tracking.
• Rich Product Cards: Renders media groups, detailed descriptions formatted in HTML blockquotes, and intelligent "Back to Category Page" buttons that compute the exact page index the user came from.
• Clean Session Management: Automatic message deletion and cleanup upon closing product cards or changing views.

---

🛠️ Tech Stack

• Language: Python 3.11+
• Framework: Kurigram (High-performance Pyrogram fork)
• Configuration: python-dotenv
• Data Storage: Python Native Data Structures (JSON-like in-memory dictionary)

---

📐 Project Structure

NeChainik/
├── media/              # Product photos directory
│   └── *.jpg
├── assortment.py       # Full catalog data structure (Categories & Products)
├── config.py           # Environment variables validator
├── main.py             # Bot logic, event handlers, and pagination
├── .env.example        # Environment template
├── requirements.txt    # Project dependencies
└── README.md

---

🚀 Quick Start & Installation

1. Clone the repository:

   git clone https://github.com/cxvimba/NeChainik.git
   cd NeChainik

2. Set up virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   pip install -r requirements.txt

3. Configure Environment: Copy .env.example to .env and insert your Telegram credentials:

   cp .env.example .env

   Fill in BOT_TOKEN, TELEGRAM_API_ID, and TELEGRAM_API_HASH.

4. Run the bot:

   python main.py

---

📝 Client Feedback

"Thank you for creating the Telegram bot! The work was completed with high quality, on time, and considering all my requests. The bot runs stably, the interface is convenient and clear. Recommended for cooperation — professional approach and very pleasant communication!"
— Vyacheslav A. (Client)