Skip to content

Shaxob-py/ajr-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

14 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒฟ AjrQoraSedan Bot

AjrQoraSedan Demo

Python Aiogram PostgreSQL License Status

A comprehensive Telegram bot providing detailed information about Black Seed (Qora Sedana) with expert consultation services


๐ŸŒŸ Overview

AjrQoraSedan is an intelligent Telegram bot designed to educate users about the remarkable health benefits of Black Seed (Qora Sedana) - a natural superfood with centuries of traditional use. The bot not only provides comprehensive information but also connects users with certified specialists for personalized consultations.

โœจ Key Features

  • ๐Ÿ“š Comprehensive Database - Extensive information about Black Seed benefits, usage, and research
  • ๐Ÿ‘จโ€โš•๏ธ Expert Consultation - Free direct access to certified specialists
  • ๐ŸŒ Multi-language Support - Available in multiple languages
  • ๐Ÿ“Š User Analytics - Track engagement and popular queries
  • ๐Ÿ”” Smart Notifications - Personalized health tips and reminders
  • ๐Ÿ’ฌ Interactive Chat - Natural conversation flow with intelligent responses

๐ŸŽฏ Project Goals

Our mission is to make natural health information accessible to everyone through technology:

  • Educate users about the scientifically-proven benefits of Black Seed
  • Connect people with qualified health specialists
  • Promote natural wellness solutions
  • Build a community of health-conscious individuals

๐Ÿ› ๏ธ Technology Stack

Python
Python 3.8+
Aiogram
Aiogram 3.0+
PostgreSQL
PostgreSQL
SQLAlchemy
SQLAlchemy

๐Ÿ”ง Additional Dependencies

  • asyncio - Asynchronous programming support
  • aiohttp - HTTP client/server for asyncio
  • python-dotenv - Environment variable management
  • psycopg2 - PostgreSQL adapter
  • redis - Caching and session management

๐Ÿš€ Quick Start

Prerequisites

Before running the bot, ensure you have:

  • Python 3.8 or higher
  • PostgreSQL database
  • Telegram Bot Token (from @BotFather)
  • Git installed

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/ajrqorasedan.git cd ajrqorasedan
  2. Create and activate virtual environment

    # On macOS/Linux python3 -m venv venv source venv/bin/activate # On Windows python -m venv venv venv\Scripts\activate
  3. Install dependencies

    pip install -r requirements.txt
  4. Environment setup

    # Create .env file cp .env.example .env # Edit .env with your credentials nano .env
  5. Database setup

    # Create database tables python setup_db.py # Run migrations (if any) python migrate.py
  6. Run the bot

    python bot.py

๐Ÿ”ง Configuration

Create a .env file in the root directory with the following variables:

# Bot Configuration BOT_TOKEN=your_telegram_bot_token_here ADMIN_ID=your_telegram_user_id # Database Configuration DATABASE_URL=postgresql://username:password@localhost:5432/ajrbot_db # Redis Configuration (Optional) REDIS_URL=redis://localhost:6379 # Logging LOG_LEVEL=INFO # API Keys (if needed) OPENAI_API_KEY=your_openai_key_here


๐ŸŽฎ Bot Commands

Command Description
/start Initialize the bot and show welcome message
@your_bot_username search

๐ŸŒ Features in Detail

๐Ÿ“š Information System

  • Comprehensive database of Black Seed benefits
  • Scientific research references
  • Usage guidelines and dosage recommendations
  • Side effects and contraindications

ders


๐Ÿ“Š Performance Monitoring

The bot includes built-in monitoring features:

  • Response Time Tracking - Monitor bot response times
  • Error Logging - Comprehensive error tracking
  • User Analytics - Track user interactions and engagement
  • Health Checks - Automated system health monitoring

๐Ÿ”’ Security Features

  • Data Encryption - All sensitive data is encrypted
  • Rate Limiting - Prevents spam and abuse
  • Input Validation - Validates all user inputs
  • Access Control - Admin-only commands and features

Manual Deployment

# Install production dependencies pip install -r requirements.txt # Set environment variables export BOT_TOKEN=your_token_here export DATABASE_URL=your_database_url # Run with gunicorn (if using webhooks) gunicorn -w 4 -k uvicorn.workers.UvicornWorker app:app

๐Ÿค Contributing

We welcome contributions! Please follow these steps:

  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

Development Guidelines

  • Follow PEP 8 style guidelines
  • Write unit tests for new features
  • Update documentation for any changes
  • Use meaningful commit messages

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ“ž Support

If you encounter any issues or have questions:

Email Telegram

๐Ÿ™ Acknowledgments

  • Thanks to all contributors who helped build this project
  • Special thanks to the natural health community for their support
  • Inspired by the ancient wisdom of traditional medicine

Made with โค๏ธ for natural health enthusiasts

โญ Star this repository if you find it helpful!

About

Telegram bot for Ajr Qora Sedana brand to automate customer support and marketing

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages