https://github.com/ummataliyev/djangogram
🟢 Django + Aiogram Telegram bot boilerplate with polling/webhook, Nginx, Ngrok, async DB, logging, and modular handlers.
https://github.com/ummataliyev/djangogram
aiogram-bot-template django django-unfold docker nginx ngrok polling postgresql sync-async webhook
Last synced: 8 months ago
JSON representation
🟢 Django + Aiogram Telegram bot boilerplate with polling/webhook, Nginx, Ngrok, async DB, logging, and modular handlers.
- Host: GitHub
- URL: https://github.com/ummataliyev/djangogram
- Owner: ummataliyev
- Created: 2025-11-02T15:26:10.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-11-02T16:34:11.000Z (8 months ago)
- Last Synced: 2025-11-02T17:26:09.661Z (8 months ago)
- Topics: aiogram-bot-template, django, django-unfold, docker, nginx, ngrok, polling, postgresql, sync-async, webhook
- Language: Python
- Homepage:
- Size: 58.6 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# Djangogram ⚡️
## Production-Ready Django + Aiogram Telegram Bot
A production-ready **Django + Aiogram Telegram bot** boilerplate.
---
## Features
- ✅ Polling mode (development)
- ✅ Webhook mode (production)
- ✅ Ngrok integration (for local webhook testing)
- ✅ Nginx reverse proxy ready
- ✅ Async PostgreSQL operations with Django ORM
- ✅ Celery for background tasks & scheduling
- ✅ Modular handler/router structure
- ✅ Structured logging
- ✅ Dockerized environment (PostgreSQL, Redis, Nginx)
---
## Getting Started
### 1. Clone the repository
```bash
git clone git@github.com:ummataliyev/djangogram.git
cd djangogram
```
### 2. Create .env file
Create a .env file for development:
```bash
cp docker/development/.env-example docker/development/.env
```
Create a .env file for production:
```bash
cp docker/development/.env-example docker/production/.env
```
### 3. Check available commands
```bash
make help
```