Skip to content

Readme.md

Latest commit

 

History

History
116 lines (75 loc) · 3.05 KB

Readme.md

File metadata and controls

116 lines (75 loc) · 3.05 KB

🤖 SMIGAI: AI Agent for Social Media Content & Image Generation

This AI Agent generates social media content and visuals for a brand or company using their URL or domain. It utilizes cutting-edge AI services via:

✨ Features

  • Generate engaging social media posts tailored to a company's brand or website
  • Automatically create AI-generated images relevant to the brand
  • Simple web interface to test and run content/image generation
  • Plug-and-play with OpenRouter, Hugging Face, or Stability AI APIs

🔧 Setup & Installation

1. Clone the repository

git clone https://github.com/vikukumar/SMIGAI.git
cd SMIGAI

2. Create .env file

Create a .env file in the root directory with the following content:

OPENROUTER_API_KEY=''     # Required for text generation (Mandatory)
HF_API_KEY=''             # Optional (for image generation via Hugging Face)
STABILITY_API_KEY=''      # Optional (alternative for image generation)

Note: Image generation requires at least one of HF_API_KEY or STABILITY_API_KEY. If neither is provided, image generation will not work.

3. Install dependencies

pip install -r requirements.txt

4. Run the application

python run.py

Access the app at: http://localhost:5000

✅ Requirements

📂 Project Structure

├── run.py               # Main application entrypoint
├── .env                 # Environment variables for API keys
├── app.py                 # Main App which is running on FastAPI
├── requirements.txt     # Python dependencies
├── public/              # Static files like Html, CSS, JS, or placeholder images
├── lib/               # Core logic for AI interactions
│   └── agent.py   # OpenRouter-powered content generator and Hugging Face / Stability AI image generation

🚀 Use Cases

  • Social media teams wanting fast content ideas and visuals
  • Startups or brands without dedicated content creators
  • Automating marketing pipelines with AI

🛠️ Built With

📃 License

VIKSHRO License

📬 Contacts

Vikash Kumar - Github Vikash Kumar - LinkedIn

Let me know if you want the project to be Dockerized or deployed to platforms like Vercel, Heroku, or AWS!