How chadoyev/instagram-auto-publisher works
Instagram Auto Publisher is a Telegram-operated content pipeline: users submit social-media links, the bot downloads files for users and review, admins moderate submissions, and approved items are scheduled for Instagram publication. Admin capabilities also include broadcast, subscription controls, scheduling settings, and Instagram session management. The graph reflects the README and source-index references; some implementation details and runtime wiring are unsampled, so uncertain links are omitted.
Main entry points: repositories Data repositories · instagram_publisher.py Instagram publisher · __main__.py Bot startup · admin_menu.py Admin controls
Components 26
Telegram bot
- Bot startup
app/__main__.py - Bot factory
app/bot/factory.py - Bot handlers
app/bot/handlers - Admin controls
app/bot/handlers/admin_menu.py - Broadcast
app/bot/handlers/broadcast.py - Subscriptions
app/bot/handlers/subscription.py
Content workflow
- Download requests
app/bot/handlers/download.py - Downloader router
app/services/downloaders/router.py - Platform downloaders
app/services/downloaders - Content review
app/bot/handlers/content_review.py
Publishing
- Instagram session
app/bot/handlers/instagram_auth.py - Phase scheduler
app/services/scheduler.py - Instagram publisher
app/services/instagram_publisher.py - Watermark processing
app/services/watermark.py
Persistence
- Data repositories
app/db/repositories - Content and schedule models
app/db/models.py - Database engine
app/db/engine.py
Configuration
- Application settings
app/settings.py - Webhook endpoint
app/web/webhook.py
Other components
- Bot user
- Administrator
- Telegram
- TikTok API
- HikerAPI
- YouTube
Connections 35
- Bot startup → Bot factory: creates bot
app/__main__.py - Bot startup → Database engine: initializes
app/__main__.py - Bot startup → Phase scheduler: starts
app/__main__.py - Bot startup → Webhook endpoint: uses in webhook mode
app/__main__.py - Bot factory → Bot handlers: registers
app/bot/factory.py - Bot user → Telegram: sends links
README.md - Administrator → Telegram: reviews and manages
README.md - Telegram → Bot handlers: dispatches updates
- Bot handlers → Download requests: routes requests
- Download requests → Downloader router: requests download
app/bot/handlers/download.py - Downloader router → Platform downloaders: dispatches platform
app/services/downloaders/router.py - Downloader router → Data repositories: persists content
app/services/downloaders/router.py - Platform downloaders → TikTok API: downloads from
README.md - Platform downloaders → HikerAPI: downloads from
README.md - Platform downloaders → YouTube: downloads from
README.md - Download requests → Bot user: returns files
README.md - Content review → Data repositories: reads and updates
app/bot/handlers/content_review.py - Content review → Administrator: presents review items
README.md - Content review → Phase scheduler: queues approvals
- Data repositories → Content and schedule models: operates on
app/db/repositories/__init__.py - Database engine → Content and schedule models: creates schema
app/db/engine.py - Phase scheduler → Data repositories: loads schedule and queue
app/services/scheduler.py - Phase scheduler → Instagram publisher: publishes queued item
app/services/scheduler.py - Instagram publisher → Watermark processing: processes media
app/services/instagram_publisher.py - Instagram publisher → Instagram: publishes media
README.md - Instagram session → Instagram publisher: manages session
app/bot/handlers/instagram_auth.py - Admin controls → Data repositories: reads and updates
app/bot/handlers/admin_menu.py - Admin controls → Watermark processing: manages logo
app/bot/handlers/admin_menu.py - Admin controls → Broadcast: opens workflow
- Admin controls → Subscriptions: opens workflow
- Subscriptions → Data repositories: manages requirements
app/bot/handlers/subscription.py - Administrator → Broadcast: sends announcements
README.md - Administrator → Subscriptions: configures channel access
README.md - Application settings → Database engine: configures connection
app/db/engine.py - Application settings → Instagram publisher: configures account
app/services/instagram_publisher.py