{"id":47932462,"url":"https://github.com/xvvcs/vinted-desc-generator","last_synced_at":"2026-04-04T07:22:06.692Z","repository":{"id":284049542,"uuid":"953657348","full_name":"xvvcs/vinted-desc-generator","owner":"xvvcs","description":"A free powerful tool that generates professional, multilingual descriptions for Vinted listings using Gemini AI.","archived":false,"fork":false,"pushed_at":"2025-03-30T21:34:41.000Z","size":37802,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T22:27:02.624Z","etag":null,"topics":["ai","gemini-ai","gemini-api","generative-ai","generator","localhost","vinted","vinted-bot","vinted-script"],"latest_commit_sha":null,"homepage":"","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/xvvcs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-23T21:05:09.000Z","updated_at":"2025-03-30T21:34:44.000Z","dependencies_parsed_at":"2025-03-23T22:31:26.150Z","dependency_job_id":null,"html_url":"https://github.com/xvvcs/vinted-desc-generator","commit_stats":null,"previous_names":["xvvcs/vinted-desc-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/xvvcs/vinted-desc-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvvcs%2Fvinted-desc-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvvcs%2Fvinted-desc-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvvcs%2Fvinted-desc-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvvcs%2Fvinted-desc-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xvvcs","download_url":"https://codeload.github.com/xvvcs/vinted-desc-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvvcs%2Fvinted-desc-generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31391437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai","gemini-ai","gemini-api","generative-ai","generator","localhost","vinted","vinted-bot","vinted-script"],"created_at":"2026-04-04T07:22:06.013Z","updated_at":"2026-04-04T07:22:06.684Z","avatar_url":"https://github.com/xvvcs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Vintly\n\nQuick? Effortless? Simple to use? That's Vintly, a powerful tool that generates professional, multilingual descriptions for Vinted listings using AI. Upload your product images and get detailed, SEO-optimized descriptions in multiple languages.\n\n![Vintly Logo](img/vintly-logo.png)\n\n\u003cdiv align=\"center\"\u003e\n  \n[![Python](https://img.shields.io/badge/Python-3.12.9-blue.svg)](https://www.python.org/)\n[![Flask](https://img.shields.io/badge/Flask-3.1.0-lightgrey.svg)](https://flask.palletsprojects.com/)\n[![SQLAlchemy](https://img.shields.io/badge/SQLAlchemy-3.1.1-red.svg)](https://www.sqlalchemy.org/)\n[![Google Gemini AI](https://img.shields.io/badge/Gemini_AI-0.8.4-green.svg)](https://ai.google.dev/)\n[![Pillow](https://img.shields.io/badge/Pillow-11.1.0-orange.svg)](https://python-pillow.org/)\n[![Bootstrap](https://img.shields.io/badge/Bootstrap-5.3-purple.svg)](https://getbootstrap.com/)\n[![JavaScript](https://img.shields.io/badge/JavaScript-ES6-yellow.svg)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)\n\n\u003c/div\u003e\n\u003c/div\u003e\n\n## Features\n\n- 🤖 AI-powered description generation\n- 🌍 Multilingual support (English, Polish, Danish)\n- 🖼️ Drag-and-drop image upload\n- 🎨 Multiple description styles (Professional, Casual, Detailed)\n- 📏 Custom measurements support\n- 🏷️ Category-specific descriptions\n- 🌓 Dark/Light mode\n- 💾 Save your preferences\n- 📋 Copy to clipboard functionality\n\n## Video Demo\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/demo.gif\" alt=\"Vintly Demo\"\u003e\n\u003c/div\u003e\n\n### ⚡ Quick Windows Installation ⚡\n\nFor Windows users, I've created a simplified installation process:\n\n1. Download and extract the ZIP file\n2. Double-click on `setup_windows.bat`\n3. Follow the prompts to install dependencies and enter your Google API key\n4. When setup completes, choose \"Y\" to start Vintly immediately, or\n5. Double-click `run_vintly.bat` anytime you want to start the application\n\nThe setup script takes care of everything - no need to manually create files or edit configurations!\n\nNeed more details? Follow the complete installation steps below.\n\n### ⚡ Quick Mac/Linux Installation ⚡\n\nFor Mac/Linux users, I've created a streamlined setup process:\n\n1. Download and extract the ZIP file\n2. Open Terminal and navigate to the extracted folder\n3. Make the scripts executable: `chmod +x setup_mac.sh run-vintly.sh`\n4. Run the setup script: `./setup_mac.sh`\n5. The script will check if Python 3.12.9 is installed:\n\n- If not installed and you have Homebrew, it will automatically install Python 3.12.9\n- If Homebrew is not found, it will offer to install it for you\n- Follow the prompts to complete the Python installation\n\n6. Follow the remaining prompts to:\n\n- Create a virtual environment (recommended)\n- Install dependencies\n- Enter your Google API key\n\n7. When setup completes, choose \"Y\" to start Vintly immediately, or\n8. Run `./run-vintly.sh` anytime you want to start the application\n\n## 💻 Installation\n\n### Prerequisites\n\nBefore you start, make sure you have these installed on your computer:\n\n1. **Python 3.12.9**\n\n   Python is the programming language needed to run Vintly.\n\n   - **Windows**:\n\n     - Download from [Python's official website](https://www.python.org/downloads/)\n     - **IMPORTANT**: During installation, check the box that says \"Add Python to PATH\". Make sure you install Python 3.12.9!!!\n     - To verify installation: Open Command Prompt (search for \"cmd\" in Start menu) and type:\n       ```\n       python --version\n       ```\n\n   - **Mac**:\n     - Most Macs come with Python installed\n     - To verify installation: Open Terminal (find in Applications \u003e Utilities) and type:\n       ```\n       python3 --version\n       ```\n     - If not installed, download from [Python's official website](https://www.python.org/downloads/)\n\n2. **Google API key for Gemini AI**\n   - Go to [Google AI Studio](https://makersuite.google.com/app/apikey)\n   - Sign in with your Google account\n   - Click \"Create API Key\"\n   - Copy your API key (you'll need it in Step 4)\n\n### Step-by-Step Installation with Pictures\n\n1. **Download the Program**\n\n   - Download the ZIP file from the download link\n   - Extract/unzip the file to a folder on your computer\n   - Remember where you saved it! (Example: Desktop/vintly)\n\n2. **Open Terminal/Command Prompt**\n\n   - **Windows**:\n\n     - Press Windows key + R\n     - Type \"cmd\" and press Enter\n     - Navigate to your folder by typing (replace with your actual path):\n       ```\n       cd Desktop\\vintly\n       ```\n\n   - **Mac**:\n     - Open Terminal (Applications \u003e Utilities \u003e Terminal)\n     - Navigate to your folder by typing (replace with your actual path):\n       ```\n       cd Desktop/vintly\n       ```\n\n3. **Set Up Python Environment** (Optional)\n\n   A virtual environment is like a separate space for Vintly that won't affect other programs.\n\n   - Create a virtual environment:\n\n     **Windows**:\n\n     ```\n     python -m venv .venv\n     ```\n\n     **Mac**:\n\n     ```\n     python3 -m venv .venv\n     ```\n\n   - \u003ci\u003eMake sure you make running the shell scripts available\u003c/i\u003e\n\n     **Windows**:\n\n     ```bash\n     Set-ExecutionPolicy RemoteSigned -Scope CurrentUser\n     ```\n\n   - Activate the virtual environment:\n\n     **Windows**:\n\n     ```\n     .venv\\Scripts\\activate\n     ```\n\n     **Mac**:\n\n     ```\n     source .venv/bin/activate\n     ```\n\n   You'll know it's working when you see `(.venv)` at the beginning of your command line.\n\n4. **Install Required Packages**\n\n   - With the virtual environment activated, run:\n     ```\n     pip install -r requirements.txt\n     ```\n   - This may take a few minutes as it downloads all necessary components\n\n5. **Set Up API Key**\n\n   - Create a new text file in the program folder.\n     (You can do so by using nano):\n\n     ```\n     nano .env\n     ```\n\n     Or by doing it normal way:\n\n   - Name it exactly `.env` (including the period at the beginning)\n   - Open it with Notepad (Windows) or TextEdit (Mac)\n   - Type ONLY this line, replacing with your actual API key:\n     ```\n     GOOGLE_API_KEY=your_api_key_here\n     ```\n   - Save the file\n   - **WARNING**: The file must contain ONLY this line with no comments or other text!\n\n6. **Run the Program**\n\n   - \u003ci\u003e(if used python environment) Make sure your virtual environment is active (you'll see `(.venv)` in your terminal)\u003c/i\u003e\n   - Run:\n\n     **Windows**:\n\n     ```\n     python app.py\n     ```\n\n     **Mac**:\n\n     ```\n     python3 app.py\n     ```\n\n   - You should see a message that says the server is running\n   - Open your web browser and go to: `http://your-ip:5001` **You can see the exact host ips in the cmd message after running the app**\n\n### ❓ Troubleshooting\n\nIf you encounter any issues:\n\n1. **\"Python is not recognized\" error**\n\n   - Windows: Reinstall Python and make sure to check \"Add Python to PATH\"\n   - Mac: Try using `python3` instead of `python`\n\n2. **API key not working**\n\n   - Make sure your `.env` file contains ONLY the API key line with no comments\n   - Ensure there are no spaces around the equals sign\n   - Check that you've copied the entire key correctly\n   - Try generating a new API key at Google AI Studio\n\n3. **\"Module not found\" errors**\n\n   - Make sure you see `(.venv)` in your terminal\n   - Try running `pip install -r requirements.txt` again\n\n4. **Can't connect to the application**\n\n   - Make sure the terminal shows the server is running\n   - Try going to `http://localhost:5001` in your browser\n   - Check if any antivirus or firewall is blocking the connection\n\n5. **Description generation fails**\n   - Your API key might have expired - generate a new one\n   - Make sure you have internet connection\n   - Try with a smaller image file\n\n## 🖱️ How to Use Vintly\n\n1. **Upload Images**\n\n   - Drag and drop images or click to select files\n   - Supported formats: PNG, JPG, JPEG\n   - Maximum file size: 16MB\n\n2. **Add Product Details**\n\n   - Enter measurements (e.g., chest 40cm, length 70cm)\n   - Select category: Clothing, Shoes, or Accessories\n   - Choose a description style\n\n3. **Generate Description**\n\n   - Click the \"Generate Description\" button\n   - The AI will create a description based on your image and information\n   - Copy the text with the \"Copy to Clipboard\" button\n\n4. **Customize Your Experience**\n   - Use the Settings button (⚙️) to set preferred languages\n   - Switch between Light/Dark mode with the moon/sun icon\n   - Create templates on the Templates page for consistent descriptions\n\nNeed help? Feel free to contact me in dm or create an issue.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Author\n\nxvvcs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxvvcs%2Fvinted-desc-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxvvcs%2Fvinted-desc-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxvvcs%2Fvinted-desc-generator/lists"}