https://github.com/xvvcs/vinted-desc-generator
A free powerful tool that generates professional, multilingual descriptions for Vinted listings using Gemini AI.
https://github.com/xvvcs/vinted-desc-generator
ai gemini-ai gemini-api generative-ai generator localhost vinted vinted-bot vinted-script
Last synced: 3 months ago
JSON representation
A free powerful tool that generates professional, multilingual descriptions for Vinted listings using Gemini AI.
- Host: GitHub
- URL: https://github.com/xvvcs/vinted-desc-generator
- Owner: xvvcs
- License: mit
- Created: 2025-03-23T21:05:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-30T21:34:41.000Z (over 1 year ago)
- Last Synced: 2025-03-30T22:27:02.624Z (over 1 year ago)
- Topics: ai, gemini-ai, gemini-api, generative-ai, generator, localhost, vinted, vinted-bot, vinted-script
- Language: Python
- Homepage:
- Size: 36.1 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
[](https://www.python.org/)
[](https://flask.palletsprojects.com/)
[](https://www.sqlalchemy.org/)
[](https://ai.google.dev/)
[](https://python-pillow.org/)
[](https://getbootstrap.com/)
[](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
## 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](https://www.python.org/downloads/)
- **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](https://www.python.org/downloads/)
2. **Google API key for Gemini AI**
- Go to [Google AI Studio](https://makersuite.google.com/app/apikey)
- 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**:
```bash
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