Vintly

Quick? 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.

Features

• 🤖 AI-powered description generation
• 🌍 Multilingual support (English, Polish, Danish)
• 🖼️ Drag-and-drop image upload
• 🎨 Multiple description styles (Professional, Casual, Detailed)
• 📏 Custom measurements support
• 🏷️ Category-specific descriptions
• 🌓 Dark/Light mode
• 💾 Save your preferences
• 📋 Copy to clipboard functionality

Video Demo

⚡ Quick Windows Installation ⚡

For Windows users, I've created a simplified installation process:

1. Download and extract the ZIP file
2. Double-click on setup_windows.bat
3. Follow the prompts to install dependencies and enter your Google API key
4. When setup completes, choose "Y" to start Vintly immediately, or
5. Double-click run_vintly.bat anytime you want to start the application

The setup script takes care of everything - no need to manually create files or edit configurations!

Need more details? Follow the complete installation steps below.

⚡ Quick Mac/Linux Installation ⚡

For Mac/Linux users, I've created a streamlined setup process:

1. Download and extract the ZIP file
2. Open Terminal and navigate to the extracted folder
3. Make the scripts executable: chmod +x setup_mac.sh run-vintly.sh
4. Run the setup script: ./setup_mac.sh
5. The script will check if Python 3.12.9 is installed:

• If not installed and you have Homebrew, it will automatically install Python 3.12.9
• If Homebrew is not found, it will offer to install it for you
• Follow the prompts to complete the Python installation

6. Follow the remaining prompts to:

• Create a virtual environment (recommended)
• Install dependencies
• Enter your Google API key

7. When setup completes, choose "Y" to start Vintly immediately, or
8. Run ./run-vintly.sh anytime you want to start the application

💻 Installation

Prerequisites

Before you start, make sure you have these installed on your computer:

1. Python 3.12.9

   Python is the programming language needed to run Vintly.

   • Windows:

     • Download from Python's official website
     • IMPORTANT: During installation, check the box that says "Add Python to PATH". Make sure you install Python 3.12.9!!!
     • To verify installation: Open Command Prompt (search for "cmd" in Start menu) and type:

       python --version
       

   • Mac:

     • Most Macs come with Python installed
     • To verify installation: Open Terminal (find in Applications > Utilities) and type:

       python3 --version
       

     • If not installed, download from Python's official website

2. Google API key for Gemini AI

   • Go to Google AI Studio
   • Sign in with your Google account
   • Click "Create API Key"
   • Copy your API key (you'll need it in Step 4)

Step-by-Step Installation with Pictures

1. Download the Program

   • Download the ZIP file from the download link
   • Extract/unzip the file to a folder on your computer
   • Remember where you saved it! (Example: Desktop/vintly)

2. Open Terminal/Command Prompt

   • Windows:

     • Press Windows key + R
     • Type "cmd" and press Enter
     • Navigate to your folder by typing (replace with your actual path):

       cd Desktop\vintly
       

   • Mac:

     • Open Terminal (Applications > Utilities > Terminal)
     • Navigate to your folder by typing (replace with your actual path):

       cd Desktop/vintly
       

3. Set Up Python Environment (Optional)

   A virtual environment is like a separate space for Vintly that won't affect other programs.

   • Create a virtual environment:

     Windows:

     python -m venv .venv
     

     Mac:

     python3 -m venv .venv
     

   • Make sure you make running the shell scripts available

     Windows:

     Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

   • Activate the virtual environment:

     Windows:

     .venv\Scripts\activate
     

     Mac:

     source .venv/bin/activate
     

   You'll know it's working when you see (.venv) at the beginning of your command line.

4. Install Required Packages

   • With the virtual environment activated, run:

     pip install -r requirements.txt
     

   • This may take a few minutes as it downloads all necessary components

5. Set Up API Key

   • Create a new text file in the program folder. (You can do so by using nano):

     nano .env
     

     Or by doing it normal way:

   • Name it exactly .env (including the period at the beginning)

   • Open it with Notepad (Windows) or TextEdit (Mac)

   • Type ONLY this line, replacing with your actual API key:

     GOOGLE_API_KEY=your_api_key_here
     

   • Save the file

   • WARNING: The file must contain ONLY this line with no comments or other text!

6. Run the Program

   • (if used python environment) Make sure your virtual environment is active (you'll see (.venv) in your terminal)

   • Run:

     Windows:

     python app.py
     

     Mac:

     python3 app.py
     

   • You should see a message that says the server is running

   • 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

❓ Troubleshooting

If you encounter any issues:

1. "Python is not recognized" error

   • Windows: Reinstall Python and make sure to check "Add Python to PATH"
   • Mac: Try using python3 instead of python

2. API key not working

   • Make sure your .env file contains ONLY the API key line with no comments
   • Ensure there are no spaces around the equals sign
   • Check that you've copied the entire key correctly
   • Try generating a new API key at Google AI Studio

3. "Module not found" errors

   • Make sure you see (.venv) in your terminal
   • Try running pip install -r requirements.txt again

4. Can't connect to the application

   • Make sure the terminal shows the server is running
   • Try going to http://localhost:5001 in your browser
   • Check if any antivirus or firewall is blocking the connection

5. Description generation fails

   • Your API key might have expired - generate a new one
   • Make sure you have internet connection
   • Try with a smaller image file

🖱️ How to Use Vintly

1. Upload Images

   • Drag and drop images or click to select files
   • Supported formats: PNG, JPG, JPEG
   • Maximum file size: 16MB

2. Add Product Details

   • Enter measurements (e.g., chest 40cm, length 70cm)
   • Select category: Clothing, Shoes, or Accessories
   • Choose a description style

3. Generate Description

   • Click the "Generate Description" button
   • The AI will create a description based on your image and information
   • Copy the text with the "Copy to Clipboard" button

4. Customize Your Experience

   • Use the Settings button (⚙️) to set preferred languages
   • Switch between Light/Dark mode with the moon/sun icon
   • Create templates on the Templates page for consistent descriptions

Need help? Feel free to contact me in dm or create an issue.

License

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

Author

xvvcs