https://github.com/varsha-1605/sociosell
The Social Media to Product Listings Generator is an open-source AI tool that transforms social media product showcases into structured, detailed listings optimized for e-commerce platforms like Amazon. https://devfolio.co/projects/sociosell-63b7
https://github.com/varsha-1605/sociosell
css fastapi generative-ai html5 javascript mongodb-atlas open-source opensourcecontributions python swoc2025 talwindcss
Last synced: 9 months ago
JSON representation
The Social Media to Product Listings Generator is an open-source AI tool that transforms social media product showcases into structured, detailed listings optimized for e-commerce platforms like Amazon. https://devfolio.co/projects/sociosell-63b7
- Host: GitHub
- URL: https://github.com/varsha-1605/sociosell
- Owner: Varsha-1605
- License: mit
- Created: 2024-11-22T03:59:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-21T13:51:26.000Z (over 1 year ago)
- Last Synced: 2025-07-29T12:36:44.483Z (12 months ago)
- Topics: css, fastapi, generative-ai, html5, javascript, mongodb-atlas, open-source, opensourcecontributions, python, swoc2025, talwindcss
- Language: Python
- Homepage: https://sociosell.onrender.com/
- Size: 22.9 MB
- Stars: 22
- Watchers: 1
- Forks: 25
- Open Issues: 9
-
Metadata Files:
- Readme: Readme.md
- Contributing: docs/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
- Security: docs/SECURITY.md
Awesome Lists containing this project
README
🎉 Selected for Social Winter of Code 2025! 🎉
# SocioSell: Social Media to Product Listing Generator 🛍️
[](https://www.python.org/)
[](https://fastapi.tiangolo.com/)
[](https://www.mongodb.com/atlas)
[](https://cloud.google.com/ai-platform)
[](https://tailwindcss.com/)
[](LICENSE)
[](CONTRIBUTING.md)
[](https://swoc.tech)
[](https://github.com/Varsha-1605/SocioSell/graphs/contributors)
An open-source initiative to transform social media content into comprehensive Amazon-style product listings using cutting-edge AI technology.
[🌟 Features](#-features) •
[⚙️ Installation](#development-setup) •
[💡 API Endpoints](#-api-endpoints) •
[🤝 Contributing](#-contributing) •
[👥 Community](#-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](https://github.com/Varsha-1605/SocioSell/blob/main/static/folder/Untitled%20video%20-%20Made%20with%20Clipchamp.mp4)
---
# 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
```mermaid
graph LR
A[Python 3.8+] --> B[FastAPI]
B --> C[MongoDB]
B --> D[Gemini AI]
B --> E[AsyncIO]
```
### Frontend Technologies
```mermaid
graph LR
A[HTML5] --> B[TailwindCSS]
B --> C[JavaScript]
C --> D[Font Awesome]
```
## 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
```bash
Error: Failed to connect to Gemini API
Solution: Ensure GOOGLE_API_KEY is properly set in .env file
```
2. MongoDB Connection
```bash
Error: MongoDB connection failed
Solution: Verify MONGODB_URL format and network access.
Format: MONGODB_URL=mongodb+srv://:@/?retryWrites=true&w=majority
Replace , , , and with your details.
```
3. Image Processing
```bash
Error: Image processing failed
Solution: Verify image format (supported: jpg, png) and size (<5MB)
```
4. Metadata-generation-failed
```bash
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](./Deploy_Documentation.md)
## 📁 Project Structure
The detailed project structure is available in a separate file. Please refer to:
[📁 Project Structure Details](./docs/PROJECT_STRUCTURE.md)
## 💡 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:
```mermaid
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]
```
### **The detailed contributing guideline is available [here](./docs/CONTRIBUTING.md)**.
### Star this repository ⭐
## 👥 Community
- 💬 Join our [Discord Server](https://discord.gg/n34tSJ3TBs)
- 🔗 Connect on [LinkedIn](www.linkedin.com/in/varsha-dewangan-197983256)
- 🐦 Follow us on [Twitter]( https://x.com/varsha_dew454)
- 📧 Contact maintainers: varshadewangan1605@gmail.com
### 🌟 Contributors
Thanks to these wonderful people:
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- All our amazing contributors
- [Social Winter of Code](https://socialwinterofcode.com/) for selecting our project
- [Google Generative AI](https://cloud.google.com/ai-platform)
- [MongoDB Atlas](https://www.mongodb.com/atlas)
- [TailwindCSS](https://tailwindcss.com/)
- [FastAPI](https://fastapi.tiangolo.com/)
---
Made with ❤️ by the SocioSell Community
[⬆ Back to Top](#socialsell-social-media-to-product-listing-generator-)