🎉 Selected for Social Winter of Code 2025! 🎉

SocioSell: Social Media to Product Listing Generator 🛍️

An open-source initiative to transform social media content into comprehensive Amazon-style product listings using cutting-edge AI technology.

🌟 Features • ⚙️ Installation • 💡 API Endpoints • 🤝 Contributing • 👥 Community

---

🎯 Project Vision

SocioSell aims to bridge the gap between social media content and e-commerce by providing an open-source solution for automated product listing generation. Whether you're a developer, marketer, or e-commerce enthusiast, your contributions can help shape the future of social commerce.

📺 Project Demo

Watch our community demo:

🎥 Watch Demo

---

🌟 Features

🤖 AI-Powered Analysis Google Generative AI integration Smart product detection Automatic feature extraction	🔄 Smart Processing Real-time processing Async operations Intelligent matching
🎯 Product Categories Electronics Fashion Home Decor Beauty Sports Equipment	💫 User Experience Modern UI/UX Drag-and-drop uploads Interactive comparisons

⚠️ Limitations

• Maximum Processing Capacity (due to Gemini API constraints):
  • Images: Up to 5 images per request.
  • Videos: Up to 3 videos, each limited to 10 seconds in duration.

🔧 Technology Stack

Backend Infrastructure

graph LR
    A[Python 3.8+] --> B[FastAPI]
    B --> C[MongoDB]
    B --> D[Gemini AI]
    B --> E[AsyncIO]

Loading

Frontend Technologies

graph LR
    A[HTML5] --> B[TailwindCSS]
    B --> C[JavaScript]
    C --> D[Font Awesome]

Loading

Development Setup

I. Clone the repository

 git clone https://github.com/Varsha-1605/SocioSell.git  
cd SocioSell

II. Set up a virtual environment

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

III. Install dependencies

pip install -r requirements.txt  

IV. Create a .env file

cat > .env << EOL  
GOOGLE_API_KEY=your_google_api_key  
MONGODB_URL=your_mongodb_connection_string  
EOL  

V. Initialize the database

python database_setup.py  

VII. Start the development server

uvicorn main:app --reload  

VIII. Access the application

• Open your browser and go to http://localhost:8000.

Troubleshooting Common Issues

1. Gemini API Connection

Error: Failed to connect to Gemini API
Solution: Ensure GOOGLE_API_KEY is properly set in .env file

2. MongoDB Connection

Error: MongoDB connection failed
Solution: Check MONGODB_URL format and network connectivity

3. Image Processing

Error: Image processing failed
Solution: Verify image format (supported: jpg, png) and size (<5MB)

📁 Project Structure

The detailed project structure is available in a separate file. Please refer to:
📁 Project Structure Details

💡 API Endpoints

The detailed API endpoints are available in a separate file. Please refer to:
💡 API Endpoints

🤝 Contributing

We warmly welcome contributions from developers of all skill levels! Here's how you can help:

graph TD
    A[Fork Repository] --> B[Create Branch]
    B --> C[Make Changes]
    C --> D[Commit Changes]
    D --> E[Push to Branch]
    E --> F[Create Pull Request]

Loading

The detailed contributing guideline is available here.

Star this repository ⭐

👥 Community

• 💬 Join our Discord Server
• 🔗 Connect on LinkedIn
• 🐦 Follow us on Twitter
• 📧 Contact maintainers: varshadewangan1605@gmail.com

🌟 Contributors

Thanks to these wonderful people:

📄 License

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

🙏 Acknowledgments

• All our amazing contributors
• Social Winter of Code for selecting our project
• Google Generative AI
• MongoDB Atlas
• TailwindCSS
• FastAPI

---

Made with ❤️ by the SocioSell Community

⬆ Back to Top