⚡ ContentForge AI

The Next-Gen Viral Content Strategy & News Engine — powered by Meta's Llama 3.3 70B on Groq Cloud LPU.

ContentForge AI generates complete, high-accuracy, ready-to-use content strategy kits for YouTube, Instagram Reels, LinkedIn, and News — in seconds. Simply input your topic or news headline, configure parameters like tone, target audience, CTA goal, and output language, and receive a comprehensive strategy kit including click-worthy titles, opening hooks, full timestamped scripts, visual thumbnail concepts, SEO tags, and platform growth playbooks.

---

✨ Key Features & Capabilities

• 🎯 3 Click-Worthy Titles & Headlines — Platform-optimized titles with CTR rationale.
• 📰 News & Journalistic Reporting Mode — Generates authoritative headlines, 5-W (Who, What, When, Where, Why) lead paragraphs, factual breakdowns, and news bulletin script layouts (replacing legacy short-form formats).
• 🪝 15-Second Hook / Lead Script — Grabs immediate audience attention within the critical first 15 seconds.
• 📋 Comprehensive Script & Scene Breakdown — Step-by-step timestamped scripts complete with speaker voiceovers, visual B-roll prompts, and on-screen text overlay cues.
• 🎯 Target Audience Alignment — Customizable personas (e.g. Executives, Beginners, Developers, Investors).
• 📢 Goal & Call-To-Action (CTA) Strategy — Tailors scripts to drive subscribers, newsletter signups, engagement, or brand awareness.
• 🌐 Multi-Language Generation — Supports English, Spanish, Hindi, French, German, Japanese, and more.
• 🖼️ Thumbnail & Aesthetic Directions — Visual layout instructions, color schemes, focal points, and emotional triggers.
• #️⃣ 10 High-Impact SEO Keywords & Tags — Search-volume optimized keywords and platform hashtags.
• 💡 Strategic Platform Growth Playbooks — Platform-specific tactics tuned for YouTube, Instagram Reels, LinkedIn, and News broadcasts.
• 📥 Multi-Format Export — Instant export as .txt, .md (Markdown), or structured .json.
• 📜 Session History Manager — Built-in history sidebar to quickly switch between generated strategies.
• 📊 Speaking Pacing & Word Count Estimator — Real-time metrics for word count and estimated speaking time.

---

🏗️ System Architecture & Data Flow

┌──────────────────────────────────────────────────────────────────────────┐
│                         USER INTERFACE LAYER                             │
│                         (Streamlit Frontend)                             │
│  • Content Topic / News Headline        • Target Audience Persona        │
│  • Platform: YouTube/Reels/LinkedIn/News • Primary CTA / Content Goal    │
│  • Tone & Style Selection               • Output Language & Duration     │
└────────────────────────────────────┬─────────────────────────────────────┘
                                     │
                                     ▼
┌──────────────────────────────────────────────────────────────────────────┐
│                    PROMPT SYNTHESIS & CONTEXT ENGINE                     │
│  • Injects Platform-Specific Guidelines (e.g., 5-W Lead for News)        │
│  • Enforces Markdown Schema Constraints & Output Language Translation     │
│  • Formats Parameter Payload into System Instructions                    │
└────────────────────────────────────┬─────────────────────────────────────┘
                                     │
                                     │ API Call via Groq SDK
                                     ▼
┌──────────────────────────────────────────────────────────────────────────┐
│                     GROQ CLOUD INFERENCE LAYER                           │
│                     (Meta Llama 3.3 70B Versatile)                        │
│  • Ultra-fast LPU Hardware Accelerator                                   │
│  • High-Precision Context Generation & Reasoning                         │
└────────────────────────────────────┬─────────────────────────────────────┘
                                     │
                                     │ Structured Markdown Stream
                                     ▼
┌──────────────────────────────────────────────────────────────────────────┐
│                 RESPONSE PARSER & PRESENTATION LAYER                     │
│  • Tabbed View: Titles | Full Script | Visuals | SEO & Growth | Raw MD   │
│  • Session State History Manager & Quick Reloader                        │
│  • Multi-Format Exporter (.txt / .md / .json)                            │
└──────────────────────────────────────────────────────────────────────────┘

---

📁 Project Structure

ContentForge_AI/
├── .devcontainer/
│   └── devcontainer.json       # GitHub Codespaces container setup (auto-runs Streamlit)
├── .streamlit/
│   └── secrets.toml            # API Configuration file (Store GROQ_API_KEY here)
├── app.py                      # Main Streamlit Application (UI, Groq Integration, Engine)
├── requirements.txt            # Python Package Dependencies
└── README.md                   # Complete Documentation & Architecture

---

🚀 Quickstart & Installation

Step 1 — Clone or Download Project

git clone https://github.com/your-username/ContentForge_AI.git
cd ContentForge_AI

Step 2 — Get a Free Groq API Key

1. Visit Groq Console.
2. Sign up for a free account and navigate to API Keys.
3. Click Create API Key and copy your token.

Step 3 — Configure Secrets

Create a file located at .streamlit/secrets.toml in the project root:

GROQ_API_KEY = "gsk_your_actual_groq_api_key_here"

⚠️ Security Warning: Keep secrets.toml out of public version control. Add .streamlit/secrets.toml to .gitignore.

Step 4 — Install Dependencies

pip install -r requirements.txt

Step 5 — Run the Application

streamlit run app.py

Open your browser at http://localhost:8501 to start generating content strategies.

---

🧰 Tech Stack

Layer	Technology	Description
Frontend Framework	Streamlit 1.30+	Interactive Python Web Interface
Styling & UX	Custom CSS (Dark Glassmorphism)	Modern dark mode UI with custom tabs & cards
LLM Model	Meta Llama 3.3 70B Versatile	State-of-the-art open-weights language model
Inference Hardware	Groq Cloud LPU	Sub-second inference latency
Language	Python 3.10+	Core application logic
Export Formats	Plain Text (.txt), Markdown (.md), JSON (.json)	Multi-format output generation

---

📝 Usage Example: News Reporting Mode

Input Field	Selected Option / Value
Topic / Headline	AI Breakthrough: Quantum Computing Chips Pass Security Milestone
Platform	News
Tone	Professional & Journalistic
Duration	3-5 Mins Briefing
Target Audience	Industry Professionals & Executives
Primary Goal	Inform & Report Facts
Output Language	English

Generated Output Includes:

1. 3 Breaking News Headlines.
2. 15-Second Lead Paragraph following the 5-W rule.
3. Timestamped News Anchor Script & Visual Overlay Instructions.
4. Audience Impact Analysis for Industry Leaders.
5. 10 Search-Optimized News Keywords.
6. Featured News Graphic / Banner Concept.
7. Journalistic Credibility & Broadcast Distribution Tips.
8. Official Closing Call-To-Action.

---

🔒 Environment Variables & Secrets

Variable Name	Required	Purpose
GROQ_API_KEY	✅ Yes	Authentication key for Groq Cloud API inference

---

🤝 Contributing

Contributions are welcome! Please feel free to open an Issue or submit a Pull Request.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.