How unseenap/carouselqueue works
This package prepares and publishes four-slide Instagram carousels from classic and funny content queues. The main workflow selects a complete, unposted task, generates slides, uploads them to Cloudinary, publishes them through Instagram, and records the result. It also supports dry-run previews, series alternation, cooldown handling, and scheduled or manual runs. The source excerpt is partial, so details of omitted helper implementations and exact internal call wiring are not represented beyond the documented lifecycle.
Main entry points: instagram_publisher.py Publisher entry point · generated_images Classic images and covers · generated_images_2 Funny images and covers · data Posting history and cooldown
Components 16
Content preparation
- Classic and funny queues
- Classic queue
website_image_tasks.md - Funny queue
100_website_Useful_2.md - Task parsing and selection
automation/instagram_publisher.py - Carousel image assets
- Classic images and covers
generated_images - Funny images and covers
generated_images_2
Publishing runtime
- Publisher entry point
automation/instagram_publisher.py - Four-slide renderer
automation/instagram_publisher.py - Local preview
automation/instagram_publisher.py - Instagram client
automation/instagram_publisher.py
External services
- Cloudinary
- Instagram Graph API
Scheduling and state
- GitHub Actions
.github/workflows/instagram-daily.yml - Posting history and cooldown
data
Other components
- Operator / CLI
Connections 19
- Operator / CLI → Publisher entry point: runs
- GitHub Actions → Publisher entry point: runs
- Publisher entry point → Task parsing and selection: selects task
- Classic queue → Task parsing and selection: provides entries
- Funny queue → Task parsing and selection: provides entries
- Task parsing and selection → Classic images and covers: checks files
- Task parsing and selection → Funny images and covers: checks files
- Posting history and cooldown → Task parsing and selection: provides history
- Task parsing and selection → Publisher entry point: returns task
- Publisher entry point → Four-slide renderer: builds slides
- Classic images and covers → Four-slide renderer: provides images
- Funny images and covers → Four-slide renderer: provides images
- Four-slide renderer → Local preview: writes preview
- Publisher entry point → Cloudinary: uploads media
- Cloudinary → Publisher entry point: returns URLs
- Publisher entry point → Instagram client: creates carousel
- Instagram client → Instagram Graph API: verifies and publishes
- Instagram Graph API → Instagram client: returns media ID
- Publisher entry point → Posting history and cooldown: records result