🔥 ContentForge

<div align="center">

AI-powered content repurposing tool — Transform one piece of content into posts optimized for every platform.

</div>

📑 Table of Contents

• ✨ Features
• 🛠 Tech Stack
• 🚀 Quick Start
• 📖 Usage
• 💰 Monetization Ideas
• ☁️ Deployment
• 🗺 Roadmap / Future Updates
• 🤝 Contributing
• 📄 License
• Framework: Streamlit
• AI: Google Gemini API
• Language: Python

Local Setup

✨ Features

Additional controls available in the UI:

• 🎛 Tone selector — choose from formal, casual, humorous, and more
• 📏 Length control — short / medium / long output
• 😀 Emoji density — none / minimal / moderate / heavy
• #️⃣ Hashtag count — dial in the exact number you need
• ✅ CTA toggle — include or skip the call-to-action

🛠 Tech Stack

🚀 Quick Start

1. Set up your API key:

• Get a free Google Gemini API key from Google AI Studio
• Create .streamlit/secrets.toml file:

     mkdir .streamlit
     cp .streamlit/secrets.toml.example .streamlit/secrets.toml

• Add your API key to .streamlit/secrets.toml:

     GOOGLE_API_KEY = "your-key-here"

1. Run the app:

   streamlit run app.py

1. Open in browser:

• Streamlit will automatically open the app in your default browser
• Default URL: http://localhost:8501

Deploy to Streamlit Cloud

1. Push your code to GitHub (already done!)

1. Go to [Streamlit Cloud](https://share.streamlit.io/)

1. Click "New app"

1. Configure your app:

• Repository: your-username/contentforge
• Branch: main or master
• Main file path: app.py

1. Add your API key in Secrets:

• Click on "Advanced settings"
• In the "Secrets" section, add:

     GOOGLE_API_KEY = "your-google-api-key-here"

1. Click "Deploy"!

Your app will be live at: https://your-app-name.streamlit.app

Prerequisites: Python 3.8+, a free Google Gemini API key

# 1. Clone the repo
git clone https://github.com/patilanupam/ContentForge.git
cd ContentForge

# 2. Install dependencies
pip install -r requirements.txt

# 3. Configure environment
cp .env.example .env
# Open .env and set:  GOOGLE_API_KEY=your-key-here

# 4. Start the server
python app.py

Then open http://localhost:5050 in your browser. 🎉

📖 Usage

1. Paste your content (blog post, script, notes, article, etc.)
2. Select the target platform (Twitter, LinkedIn, Instagram, Newsletter, YouTube)
3. Tweak tone, length, emoji usage, and hashtag count with the optional controls
4. Click "Transform Content"
5. Copy the generated output and publish!

💰 Monetization Ideas

• Freemium Model — Free tier (5 transforms/month) + Pro tier ($9–19/month unlimited)
• API Access — Sell API access for developers building their own tools
• White Label — Offer to agencies as a fully branded white-label solution

☁️ Deployment

One-click deploy platforms:

🗺 Roadmap / Future Updates

The following improvements are planned to make ContentForge even more powerful:

🔐 User Accounts & History

• [ ] User authentication (sign-up / login)
• [ ] Save and revisit past transformations
• [ ] Personal content library

🌐 More Platforms

• [ ] TikTok script / caption generator
• [ ] Pinterest pin descriptions
• [ ] Threads (Meta) post formatter
• [ ] Reddit post/comment styler

🤖 AI Enhancements

• [ ] Custom style fine-tuning (learn from your past posts)
• [ ] Brand voice profiles — define tone, vocabulary, and style once; reuse everywhere
• [ ] Batch processing — upload a CSV of content and transform all at once
• [ ] Auto-hashtag research with real-time trend data

🎨 UX / UI Improvements

• [ ] Live character/word count per platform limit
• [ ] Side-by-side comparison view (original vs transformed)
• [ ] Dark mode
• [ ] Export to PDF, Notion, or Google Docs

📊 Analytics & Insights

• [ ] Per-platform performance tips based on current best practices
• [ ] Readability score for generated content
• [ ] Suggested posting times per platform

🔗 Integrations & Automation

• [ ] Direct one-click publish to social platforms via OAuth
• [ ] Zapier / Make (formerly Integromat) webhook support
• [ ] Browser extension for transforming content on the fly
• [ ] Scheduling queue for planned posts

💳 Monetization Upgrades

• [ ] Stripe-powered subscription billing
• [ ] Usage-based billing dashboard
• [ ] Team / agency workspaces with shared brand profiles

🤝 Contributing

Contributions are welcome! To get started:

1. Fork the repository
2. Create your feature branch: git checkout -b feature/your-feature-name
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin feature/your-feature-name
5. Open a Pull Request

Please open an issue first to discuss significant changes.

📄 License

This project is licensed under the MIT License.

<div align="center"> Built with ❤️ using <a href="https://ai.google.dev/">Google Gemini API</a> </div>