This trainable social media coaching system, GO VIRAL BRO, assists users in optimizing their online presence by identifying high-performing content, developing engaging angles, and generating tailored scripts. Designed for content creators and marketers, it leverages AI to learn from performance data, aiming to significantly boost social media engagement and strategy effectiveness.

How It Works

The system follows a structured pipeline: DISCOVER competitors' winning content and trending topics, ANGLE raw ideas using the Contrast Formula into format-specific variations, SCRIPT content with hooks and full narratives, POST to platforms, and ANALYZE performance data. A key differentiator is its "Agent Brain," an evolving memory that incorporates performance insights, and the HookGenie engine, which generates hooks based on 6 distinct patterns and composite scoring.

Quick Start & Requirements

• Primary install/run command: bash git clone https://github.com/charlesdove977/goviralbro.git && cd goviralbro && bash scripts/init-viral-command.sh
• Prerequisites: Claude Code (Latest), Python (3.10+), Node.js (18+), OpenAI API key, YouTube Data API v3 key. Optional dependencies include Instaloader and yt-dlp. Detailed setup instructions are available in SETUP.md.
• Links: CONTRIBUTING.md, LICENSE.

Highlighted Details

• Evolving Agent Brain: System memory continuously updates based on user performance data, refining topic discovery and content strategy.
• Competitor Intelligence: Scrapes and analyzes top-performing content from YouTube and Instagram, extracting engagement metrics, video transcripts, and hook structures for repurposing.
• HookGenie Engine: Generates hooks using 6 proven patterns, enhanced with composite scoring for maximum impact.
• Format-Specific Angles: Develops 5 distinct angles for each content format (longform, shortform, LinkedIn), offering 15 variations per topic.
• PDF Lead Magnet Generation: Capable of creating PDF lead magnets directly from generated scripts.

Maintenance & Community

Developed by Charles Dove, the project points to a "Skool Community" for engagement. Specific details on core maintainers, sponsorships, or a public roadmap are not detailed in the README.

Licensing & Compatibility

The project is licensed under the MIT License, generally permitting broad commercial use and integration without copyleft restrictions.

Limitations & Caveats

Content discovery is currently limited to YouTube and Instagram, with support for additional platforms planned. The system's effectiveness is dependent on the quality and quantity of performance data fed back into the Agent Brain and requires the setup and configuration of multiple API keys.