README.md

metadata

title: ContentCreator Pro - AI Social Media Assistant
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.32.1
app_file: app.py
pinned: false
tags:
  - custom-component-track
  - agent-demo-track
  - ai-agents
  - content-creation
  - social-media
  - modal
  - gradio
  - marketing
  - business

🚀 ContentCreator Pro

An AI-powered content generation tool that creates engaging, platform-optimized social media content for businesses, entrepreneurs, and content creators. Save time while maximizing your social media impact across multiple platforms.

✨ Features

• 🤖 AI-Powered Intelligence: Generate high-quality, engaging content using advanced AI
• 🌐 Multi-Platform Mastery: Get perfectly optimized content for LinkedIn, Instagram, TikTok, X (Twitter), and Facebook
• 🔍 Smart Hashtag Engine: Automatically generates relevant hashtags tailored to your industry
• 🎨 Professional Templates: Choose from various content types including promotions, announcements, and educational posts
• ⚡ Lightning Fast: Create a week's worth of content in minutes, not hours
• 🎯 Goal-Oriented: Content strategies designed to increase engagement, followers, and conversions

🛠️ Setup

Prerequisites

• Python 3.10 or higher
• Hugging Face Account
• Modal Account
• Git

Installation

1. Clone the repository:

   git clone https://huggingface.co/spaces/Agents-MCP-Hackathon/etheroi
   cd etheroi
   

2. Create and activate a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: .\venv\Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

🔑 Environment Variables

Create a .env file in the project root with the following variables:

# Required for Hugging Face Hub
HF_TOKEN=your_huggingface_token_here

# Optional: Modal configuration (for local development)
MODAL_TOKEN_ID=your_modal_token_id
MODAL_TOKEN_SECRET=your_modal_token_secret

🚀 Deployment

Local Development

1. Make sure you have all the environment variables set in your .env file
2. Run the application:

   python app.py
   

3. Open your browser to http://localhost:7860

Docker

1. Build the Docker image:

   docker build -t content-creation-agent .
   

2. Run the container:

   docker run -p 7860:7860 --env-file .env content-creation-agent
   

Hugging Face Spaces

1. Push your code to a GitHub repository
2. Create a new Space on Hugging Face
3. Configure the following settings:
   • Select "Docker" as the Space SDK
   • Set the Dockerfile path to Dockerfile
   • Add your HF_TOKEN as a secret in the Space settings
4. Deploy your Space

🤖 Technical Architecture

Core Stack

• Frontend: Gradio for interactive UI
• Backend: Python with Modal for serverless GPU inference
• AI Models:
  • Text Generation: Llama 2 7B Chat (GGUF)
  • Image Generation: Stable Diffusion XL
• Deployment: Docker container on Hugging Face Spaces

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Hugging Face for the Transformers library and model hosting
• Modal for serverless GPU inference
• Gradio for the beautiful UI components

🚀 ContentCreator Pro

An AI-powered assistant that helps businesses and creators generate platform-optimized social media content in seconds. Leveraging advanced language models through Modal's serverless GPU infrastructure, it creates engaging, brand-consistent content across multiple platforms.

🏆 Features

🤖 Smart Content Generation

• 🔍 Context-Aware: Understands your business type and target audience
• 🧠 AI-Powered: Multiple model options including Mistral 7B and Llama 2
• ⚡ Fast & Efficient: Generate content in seconds with local templates
• 🎯 Goal-Oriented: Content tailored to your specific marketing objectives

💡 Key Capabilities

• Multi-Platform Support: LinkedIn, Instagram, TikTok, X (Twitter), and Facebook
• Smart Hashtagging: Contextually relevant hashtags for better discoverability
• Professional Templates: Ready-to-use content structures for various use cases
• Customization: Fine-tune content to match your brand voice and style

🚀 Technical Architecture

🔥 Core Stack

• Frontend: Gradio for interactive UI with a clean, user-friendly interface
• Backend: Python with Modal for serverless GPU inference
• AI Models:
  • Text Generation: Multiple model options including Mistral 7B, Llama 2, and Phi-3
  • Language Support: English and Spanish models available
• Infrastructure: Auto-scaling with Modal for reliable performance

🧠 Smart Processing Pipeline

1. Input Analysis: Processes business type, target audience, and content goals
2. Content Generation: Creates platform-optimized content for each social network
3. Hashtag Generation: Context-aware hashtag suggestions based on content
4. Quality Assurance: Fallback templates ensure consistent output quality

⚡ Performance

• Speed: Generate content in seconds with local templates
• Coverage: 5 major social platforms with tailored content
• Reliability: Multiple model options and fallback mechanisms

🎯 Problem Solved

Before: Businesses struggle to maintain an active, engaging social media presence due to time constraints and lack of resources.
After: Professional, platform-optimized content in seconds, allowing businesses to focus on what they do best.

Real Impact

• ✅ Time Savings: Reduce content creation time from hours to minutes
• ✅ Consistent Quality: Professional-grade content that represents your brand well
• ✅ Better Engagement: Platform-optimized content designed to increase interaction
• ✅ Scalable Solution: Perfect for businesses of all sizes, from solopreneurs to agencies

🛠️ Quick Start

1. 📝 Input: Enter your business type, target audience, and content goals
2. 🎯 Define: Add your brand name and key message
3. 🤖 Generate: Let AI create platform-optimized content
4. 📱 Deploy: Copy and paste the generated content to your social media platforms
5. 📈 Grow: Engage with your audience and refine your strategy based on performance

🎯 Perfect For

• 👔 Entrepreneurs & Small Businesses: Professional social media presence without the marketing team
• 📱 Social Media Managers: Scale your content creation across multiple clients
• 🏢 Marketing Agencies: Deliver consistent, high-quality content for your clients
• 📈 Content Creators: Maintain an active, engaging social media presence
• 🌐 Digital Nomads: Manage your brand's social media from anywhere

💡 Key Benefits

• Time Savings: Generate a week's worth of content in minutes
• Consistency: Maintain a consistent brand voice across all platforms
• Engagement: Platform-optimized content designed to increase interaction
• Flexibility: Multiple AI models and templates to choose from
• Local & AI-Powered: Works offline with local templates or online with advanced AI

🌟 Why Choose ContentCreator Pro?

1. All-in-One Solution: Generate content for all major platforms from a single interface
2. No Design Skills Needed: Professional-quality content without the learning curve
3. Time-Efficient: Create a week's worth of content in minutes
4. Consistent Branding: Maintain a cohesive voice and style across all platforms
5. Data-Driven: AI-powered insights help improve your social media strategy

🛠️ Setup & Configuration

Prerequisites

• Python 3.8+
• Modal account for AI-powered generation (optional)
• Hugging Face account for model access

Installation

# Clone the repository
git clone https://huggingface.co/spaces/Agents-MCP-Hackathon/etheroi
cd etheroi

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your API keys

Running Locally

python app.py

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an issue to discuss potential improvements.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• 🚀 Live Application
• 🚀 Demo Show

---

Made with ❤️ by Jeremy Live - @developerjeremylive