🎉 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

---

Project WorkFlow Diagram:

---

🌟 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: Verify MONGODB_URL format and network access.  
Format: MONGODB_URL=mongodb+srv://<username>:<password>@<cluster-address>/<database>?retryWrites=true&w=majority  
Replace <username>, <password>, <cluster-address>, and <database> with your details.

3. Image Processing

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

4. Metadata-generation-failed

Error: metadata-generation-failed
Solution: Install Microsoft C++ Build Tools and upgrade pip, setuptools, and wheel:
Python versions between 3.9 and 3.12 only
1. Install from https://visualstudio.microsoft.com/visual-cpp-build-tools/.
2. Run: pip install --upgrade pip setuptools wheel

📁 Documentation for Deployment

The detailed documentation for deployment is available in a separate file. Please refer to: 📁 documentation

📁 Project Structure

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

💡 API Endpoints

Endpoint	Method	Description
/upload/	POST	Upload & analyze products
/search/{title}	GET	Search product database
/listings/{product_id}	GET	Get listing details
/compare/{product_id}	GET	Compare products
/health	GET	Check health status of DB
/pool-stats	GET	Check pool status of DB

The detailed API endpoints are available in a separate file. Please refer to: [💡 API Endpoints](./docs/PROJECT_STRUCTURE.md)

🤝 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