Skip to content

Anil-matcha/open-larryloop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

open-larryloop 🔄

Open-source larryloop alternative. Generate and publish viral carousel slides from any website automatically.

Philosophy: Daily Iteration

Post 1 carousel per day. Learn. Iterate. Grow.

Day 1:  Post → Analyze → Learn
Day 7:  7 data points, patterns emerging
Day 30: Refined strategy, proven hooks, optimal timing

The skill accumulates insights across ALL your posts in learnings.json.

Features

  • 🔍 Full Business Research - Analyzes brand, features, competitors from any URL
  • 🎨 AI Slide Generation - Creates 6 visually coherent carousel slides with Gemini (free plan available, no credit card)
  • 📱 Direct Publishing - Posts straight to your TikTok feed with auto trending music + Instagram simultaneously. No drafts, no manual steps
  • 💰 100% Free to Start - Both APIs (Gemini and upload-post.com) have free plans, no credit card required
  • 📊 Analytics Tracking - Monitors performance across all posts
  • 🔄 Learning Loop - Accumulates insights: best hooks, times, days, styles

Quick Start

# 1. Analyze website
node scripts/analyze-web.js https://your-product.com

# 2. Generate slides
GEMINI_API_KEY="..." bash scripts/generate-slides.sh

# 3. Publish
UPLOADPOST_TOKEN="..." bash scripts/publish-carousel.sh

# 4. Check analytics
UPLOADPOST_TOKEN="..." bash scripts/check-analytics.sh 7

Requirements

  • Node.js 18+
  • Playwright (npm install playwright && npx playwright install chromium)
  • uv (Python package runner)
  • jq

Environment Variables

Variable Description
GEMINI_API_KEY Google API key for Gemini image generation
UPLOADPOST_TOKEN Upload-Post API token
UPLOADPOST_USER Upload-Post username

Slide Structure

  1. Hook - Attention-grabbing question/problem
  2. Problem - Agitate the pain point
  3. Agitation - Show competition advancing
  4. Solution - Reveal your product
  5. Feature - Key benefit
  6. CTA - Call to action (Link in bio)

Credentials & Security

Required Credentials

Credential Type Where to Get
GEMINI_API_KEY Environment variable Google AI Studio
UPLOADPOST_TOKEN Environment variable upload-post.com → Dashboard → API Keys

Optional

Credential Type Description
UPLOADPOST_USER Environment variable Upload-Post username (not sensitive)

Security Notes

  • ✅ All credentials are read from environment variables, not stored in files
  • ✅ No API keys are hardcoded in any scripts
  • ✅ Website analysis only reads public web pages (no authentication scraping)
  • ✅ All generated data stays local in /tmp/carousel/

Data Flow

  1. Website URL → Analyzed by Playwright (local browser) → analysis.json
  2. Analysis → Sent to Gemini API → Returns generated images
  3. Images + Caption → Sent to Upload-Post API → Published to TikTok/Instagram
  4. Analytics → Fetched from Upload-Post API → Stored locally in learnings.json

External Services Used

Service Purpose Data Sent
Gemini API Image generation Text prompts describing slides
Upload-Post API Publishing + analytics Images, captions, profile username

No sensitive user data is transmitted. Only the content you're publishing.

Why open-larryloop vs larryloop?

Most carousel automation tools including larryloop require manual publishing or charge monthly fees. open-larryloop is different:

Feature open-larryloop Larry
Publishing Direct to feed — posts go live instantly Drafts only — you publish manually
Music Auto trending music via auto_add_music Manual — you add it yourself
Platforms TikTok + Instagram in one call Single platform, manual cross-post
Research Auto-analyzes any URL — brand, competitors, pricing, features Manual — you describe your product
Image coherence Image-to-image — slides 2-6 reference slide 1 Each slide generated independently
Image gen Gemini (free tier available) Paid image providers required
Posting service upload-post.com — free plan, no credit card Paid or self-hosted alternatives
Cost Free to start Paid subscription
Setup 3 env vars and you're posting Complex multi-tool setup

Documentation

See SKILL.md for full documentation.

License

MIT


Keywords: larryloop, open-larryloop, larryloop alternative, larry alternative, carousel automation, TikTok carousel generator, Instagram carousel AI, viral carousel slides, AI carousel from URL, social media automation, upload-post, Gemini carousel.

Releases

No releases published

Packages

 
 
 

Contributors