Skip to content

PATRUSOV/python-bot-planner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📝 Telegram Task Manager Bot

A professional, asynchronous Telegram bot built with aiogram 3.x and aiosqlite.
It allows you to organize messages, media, and personal notes into custom categories with a clean hybrid interface.


🚀 Features

  • Dynamic Categories -- Create, rename, and delete categories at runtime
  • Universal Content Support -- Save text, photos, videos, documents, and more
  • Hybrid UI -- Reply keyboards for navigation and inline keyboards for contextual actions
  • Category Management Panel -- Dedicated settings flow for full control
  • Persistent Storage -- Asynchronous SQLite database for reliable performance

📂 Project Structure

.
├── databases/          # SQLite storage directory
├── src/
│   └── main.py         # Main application entry point
├── .env                # Private environment variables (DO NOT COMMIT)
├── .gitignore          # Git exclusion rules
├── requirements.txt    # Python dependencies
└── README.md           # Project documentation

🛠 Installation

1. Clone the Repository

git clone https://github.com/PATRUSOV/python-bot-planner.git
cd python-bot-planner

2. Fill Environment File

Fill in the .env file in the project root:

BOT_TOKEN="your_token_here"
LOG_LEVEL="INFO"

3. Install Dependencies

pip install -r requirements.txt

4. Run the Bot

cd src
python main.py

⚙️ Configuration

Variable Description Default
BOT_TOKEN Telegram Bot API token from BotFather None
LOG_LEVEL Logging level: DEBUG, INFO, WARNING, ERROR INFO

📄 License

This project is open-source and available under the MIT License.

About

A professional, asynchronous Telegram bot built with aiogram 3.x and aiosqlite. It allows you to organize messages, media, and personal notes into custom categories with a clean hybrid interface.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages