{"id":23118805,"url":"https://github.com/varsha-1605/sociosell","last_synced_at":"2025-10-23T16:01:37.994Z","repository":{"id":264116653,"uuid":"892410902","full_name":"Varsha-1605/SocioSell","owner":"Varsha-1605","description":"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","archived":false,"fork":false,"pushed_at":"2025-02-21T13:51:26.000Z","size":23984,"stargazers_count":22,"open_issues_count":9,"forks_count":25,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-29T12:36:44.483Z","etag":null,"topics":["css","fastapi","generative-ai","html5","javascript","mongodb-atlas","open-source","opensourcecontributions","python","swoc2025","talwindcss"],"latest_commit_sha":null,"homepage":"https://sociosell.onrender.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Varsha-1605.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["Varsha-1605"],"buy_me_a_coffee":"varsha1605","ko_fi":null,"patreon":null,"open_collective":null,"custom":["https://www.linkedin.com/in/varsha-dewangan-197983256"]}},"created_at":"2024-11-22T03:59:58.000Z","updated_at":"2025-07-02T08:35:01.000Z","dependencies_parsed_at":"2024-12-25T05:20:38.844Z","dependency_job_id":"c17b47eb-bdfa-40e7-a237-23796547d0a3","html_url":"https://github.com/Varsha-1605/SocioSell","commit_stats":null,"previous_names":["varsha-1605/sociosell"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Varsha-1605/SocioSell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Varsha-1605%2FSocioSell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Varsha-1605%2FSocioSell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Varsha-1605%2FSocioSell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Varsha-1605%2FSocioSell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Varsha-1605","download_url":"https://codeload.github.com/Varsha-1605/SocioSell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Varsha-1605%2FSocioSell/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280647984,"owners_count":26366641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-23T02:00:06.710Z","response_time":142,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css","fastapi","generative-ai","html5","javascript","mongodb-atlas","open-source","opensourcecontributions","python","swoc2025","talwindcss"],"created_at":"2024-12-17T05:29:29.363Z","updated_at":"2025-10-23T16:01:37.822Z","avatar_url":"https://github.com/Varsha-1605.png","language":"Python","funding_links":["https://github.com/sponsors/Varsha-1605","https://buymeacoffee.com/varsha1605","https://www.linkedin.com/in/varsha-dewangan-197983256"],"categories":[],"sub_categories":[],"readme":"\u003cdiv style=\"display: flex; align-items: center; justify-content: center; padding: 20px; background-color: #1e1e2f; color: white; height: 150px;\"\u003e\n    \u003ch2\u003e🎉 Selected for Social Winter of Code 2025! 🎉\u003c/h2\u003e\n\u003c/div\u003e\n\n\n\n# SocioSell: Social Media to Product Listing Generator 🛍️\n\n[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-Latest-009688.svg)](https://fastapi.tiangolo.com/)\n[![MongoDB](https://img.shields.io/badge/MongoDB-Atlas-47A248.svg)](https://www.mongodb.com/atlas)\n[![Gemini AI](https://img.shields.io/badge/Gemini-1.5%20Pro-red.svg)](https://cloud.google.com/ai-platform)\n[![TailwindCSS](https://img.shields.io/badge/Tailwind-CSS-38B2AC.svg)](https://tailwindcss.com/)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![Social Winter of Code](https://img.shields.io/badge/SWOC-2025-orange.svg)](https://swoc.tech)\n[![Contributors](https://img.shields.io/github/contributors/Varsha-1605/SocioSell)](https://github.com/Varsha-1605/SocioSell/graphs/contributors)\n\n\u003cp align=\"center\"\u003e\n  An open-source initiative to transform social media content into comprehensive Amazon-style product listings using cutting-edge AI technology. \u003c/p\u003e\n\n[🌟 Features](#-features) •\n[⚙️ Installation](#development-setup) •\n[💡 API Endpoints](#-api-endpoints) •\n[🤝 Contributing](#-contributing) •\n[👥 Community](#-community)\n\n\u003cimg src=\"https://raw.githubusercontent.com/Varsha-1605/SocioSell/main/static/banner.png\" width=\"100%\" alt=\"Project Banner\"/\u003e\n\n\u003c/div\u003e\n\n---\n\n## 🎯 Project Vision\n\nSocioSell 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.\n\n## 📺 Project Demo\n\nWatch our community demo:\n\n[🎥 Watch Demo](https://github.com/Varsha-1605/SocioSell/blob/main/static/folder/Untitled%20video%20-%20Made%20with%20Clipchamp.mp4)\n\n---\n# Project WorkFlow Diagram:\n![Image](https://github.com/user-attachments/assets/c23279b3-fc68-4603-b496-d6df93c1fb3d)\n\n---\n\n## 🌟 Features\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ch3\u003e🤖 AI-Powered Analysis\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003eGoogle Generative AI integration\u003c/li\u003e\n        \u003cli\u003eSmart product detection\u003c/li\u003e\n        \u003cli\u003eAutomatic feature extraction\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ch3\u003e🔄 Smart Processing\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003eReal-time processing\u003c/li\u003e\n        \u003cli\u003eAsync operations\u003c/li\u003e\n        \u003cli\u003eIntelligent matching\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ch3\u003e🎯 Product Categories\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003eElectronics\u003c/li\u003e\n        \u003cli\u003eFashion\u003c/li\u003e\n        \u003cli\u003eHome Decor\u003c/li\u003e\n        \u003cli\u003eBeauty\u003c/li\u003e\n        \u003cli\u003eSports Equipment\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ch3\u003e💫 User Experience\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003eModern UI/UX\u003c/li\u003e\n        \u003cli\u003eDrag-and-drop uploads\u003c/li\u003e\n        \u003cli\u003eInteractive comparisons\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## ⚠️ Limitations  \n- **Maximum Processing Capacity** (due to Gemini API constraints):  \n  - **Images**: Up to 5 images per request.  \n  - **Videos**: Up to 3 videos, each limited to 10 seconds in duration.  \n\n## 🔧 Technology Stack\n\n### Backend Infrastructure\n```mermaid\ngraph LR\n    A[Python 3.8+] --\u003e B[FastAPI]\n    B --\u003e C[MongoDB]\n    B --\u003e D[Gemini AI]\n    B --\u003e E[AsyncIO]\n```\n\n### Frontend Technologies\n```mermaid\ngraph LR\n    A[HTML5] --\u003e B[TailwindCSS]\n    B --\u003e C[JavaScript]\n    C --\u003e D[Font Awesome]\n```\n\n## Development Setup  \n\nI. Clone the repository \n\u003e ```  \n\u003e  git clone https://github.com/Varsha-1605/SocioSell.git  \n\u003e cd SocioSell\n\u003e ```  \n\nII. Set up a virtual environment\n\u003e ```\n\u003e python -m venv venv  \n\u003e source venv/bin/activate  # Windows: \u003e venv\\Scripts\\activate  \n\u003e ```\nIII. Install dependencies\n\u003e ```\n\u003e pip install -r requirements.txt  \n\u003e ```\nIV. Create a `.env` file\n\u003e ```\n\u003e cat \u003e .env \u003c\u003c EOL  \n\u003e GOOGLE_API_KEY=your_google_api_key  \n\u003e MONGODB_URL=your_mongodb_connection_string  \n\u003e EOL  \n\u003e ```\nV. Initialize the database\n\u003e ```\n\u003e python database_setup.py  \n\u003e ```\nVII. Start the development server\n\u003e ```\n\u003e uvicorn main:app --reload  \n\u003e ```\nVIII. Access the application\n- Open your browser and go to `http://localhost:8000`.\n\n### Troubleshooting Common Issues\n\n1. Gemini API Connection\n```bash\nError: Failed to connect to Gemini API\nSolution: Ensure GOOGLE_API_KEY is properly set in .env file\n```\n\n2. MongoDB Connection\n```bash\nError: MongoDB connection failed  \nSolution: Verify MONGODB_URL format and network access.  \nFormat: MONGODB_URL=mongodb+srv://\u003cusername\u003e:\u003cpassword\u003e@\u003ccluster-address\u003e/\u003cdatabase\u003e?retryWrites=true\u0026w=majority  \nReplace \u003cusername\u003e, \u003cpassword\u003e, \u003ccluster-address\u003e, and \u003cdatabase\u003e with your details.\n```\n\n3. Image Processing\n```bash\nError: Image processing failed\nSolution: Verify image format (supported: jpg, png) and size (\u003c5MB)\n```\n\n4. Metadata-generation-failed\n```bash\nError: metadata-generation-failed\nSolution: Install Microsoft C++ Build Tools and upgrade pip, setuptools, and wheel:\nPython versions between 3.9 and 3.12 only\n1. Install from https://visualstudio.microsoft.com/visual-cpp-build-tools/.\n2. Run: pip install --upgrade pip setuptools wheel\n```\n\n## 📁 Documentation for Deployment\n\nThe detailed documentation for deployment is available in a separate file. Please refer to:\n[📁 documentation](./Deploy_Documentation.md)\n\n## 📁 Project Structure  \n\nThe detailed project structure is available in a separate file. Please refer to:  \n[📁 Project Structure Details](./docs/PROJECT_STRUCTURE.md)\n\n## 💡 API Endpoints\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003eEndpoint\u003c/th\u003e\n    \u003cth\u003eMethod\u003c/th\u003e\n    \u003cth\u003eDescription\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003e/upload/\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003ePOST\u003c/td\u003e\n    \u003ctd\u003eUpload \u0026 analyze products\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003e/search/{title}\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eGET\u003c/td\u003e\n    \u003ctd\u003eSearch product database\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003e/listings/{product_id}\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eGET\u003c/td\u003e\n    \u003ctd\u003eGet listing details\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003e/compare/{product_id}\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eGET\u003c/td\u003e\n    \u003ctd\u003eCompare products\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003e/health\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eGET\u003c/td\u003e\n    \u003ctd\u003eCheck health status of DB\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003e/pool-stats\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eGET\u003c/td\u003e\n    \u003ctd\u003eCheck pool status of DB\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\nThe detailed API endpoints are available in a separate file. Please refer to:  \n[💡 API Endpoints](./docs/PROJECT_STRUCTURE.md)\n\n## 🤝 Contributing\n\nWe warmly welcome contributions from developers of all skill levels! Here's how you can help:\n\n```mermaid\ngraph TD\n    A[Fork Repository] --\u003e B[Create Branch]\n    B --\u003e C[Make Changes]\n    C --\u003e D[Commit Changes]\n    D --\u003e E[Push to Branch]\n    E --\u003e F[Create Pull Request]\n```\n\n### **The detailed contributing guideline is available [here](./docs/CONTRIBUTING.md)**.\n\n### Star this repository ⭐\n\n## 👥 Community\n\n- 💬 Join our [Discord Server](https://discord.gg/n34tSJ3TBs)\n- 🔗 Connect on [LinkedIn](www.linkedin.com/in/varsha-dewangan-197983256)\n- 🐦 Follow us on [Twitter]( https://x.com/varsha_dew454)\n- 📧 Contact maintainers: varshadewangan1605@gmail.com\n\n### 🌟 Contributors\n\nThanks to these wonderful people:\n\n\u003ca href=\"https://github.com/Varsha-1605/SocioSell/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=Varsha-1605/SocioSell\" /\u003e\n\u003c/a\u003e\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- All our amazing contributors\n- [Social Winter of Code](https://socialwinterofcode.com/) for selecting our project\n- [Google Generative AI](https://cloud.google.com/ai-platform)\n- [MongoDB Atlas](https://www.mongodb.com/atlas)\n- [TailwindCSS](https://tailwindcss.com/)\n- [FastAPI](https://fastapi.tiangolo.com/)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nMade with ❤️ by the SocioSell Community\n\n[⬆ Back to Top](#socialsell-social-media-to-product-listing-generator-)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvarsha-1605%2Fsociosell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvarsha-1605%2Fsociosell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvarsha-1605%2Fsociosell/lists"}