X_Automation_Template

Template repo for per-handle Twitter/X automation bots. Used by the Trend2Reels dashboard to auto-provision new Twitter handles.

Setup

1. Create a new repo from this template (or use the Trend2Reels "Add Handle" flow)
2. Update config.json with your handle's niche, persona, topics, and CTAs
3. Replace seeds in src/content_vault.py with niche-specific content
4. Set GitHub Secrets (see .env.example for the full list)
5. The tweet.yml workflow runs on cron (5x/day) and manual dispatch

Required GitHub Secrets

Secret	Description
TWITTER_API_KEY	Twitter OAuth consumer key
TWITTER_API_SECRET	Twitter OAuth consumer secret
TWITTER_ACCESS_TOKEN	Twitter OAuth access token
TWITTER_ACCESS_TOKEN_SECRET	Twitter OAuth access token secret
HANDLE_ID	UUID from twitter_handles table (for Trend2Reels sync)
ANTHROPIC_API_KEY	Anthropic Claude API key
SUPABASE_URL	Supabase project URL
SUPABASE_SERVICE_ROLE_KEY	Supabase service role key

Optional: OPENAI_API_KEY, GOOGLE_GEMINI_API_KEY, EMAIL_SENDER, EMAIL_SENDER_PASSWORD, EMAIL_RECIPIENT