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.
- 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
.
├── 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
git clone https://github.com/PATRUSOV/python-bot-planner.git
cd python-bot-plannerFill in the .env file in the project root:
BOT_TOKEN="your_token_here"
LOG_LEVEL="INFO"pip install -r requirements.txtcd src
python main.py| Variable | Description | Default |
|---|---|---|
| BOT_TOKEN | Telegram Bot API token from BotFather | None |
| LOG_LEVEL | Logging level: DEBUG, INFO, WARNING, ERROR | INFO |
This project is open-source and available under the MIT License.