Skip to content

shaonfl3d/metagen-pro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 

Repository files navigation

🚀 MetaGen Pro - Offline Auto Metadata Generator

MetaGen Pro is a complete offline, browser-based application designed specifically for stock photographers, digital artists, and prompt engineers. It automates the generation of highly detailed titles, keywords, and AI image prompts without ever uploading your files to the cloud.

Not only does it generate metadata, but it also embeds the EXIF and XMP metadata directly into your JPEG images—making them instantly ready for drag-and-drop uploads to platforms like Adobe Stock, Shutterstock, Lightroom, and even recognizable by Windows File Explorer properties.

image

🌟 Features


  • 🧠 Local AI Processing: Connects to any local Vision Model via LM Studio. 100% private, runs entirely on your hardware.
  • 💾 Direct Metadata Embedding: Automatically writes generated Titles, Keywords, and Prompts directly into the image's EXIF and XMP data structure.
  • 🚀 Auto-Save & Crash Prevention: Built to handle massive batches (1000+ images). The Auto-Save feature writes processed images directly to your local drive and clears RAM instantly, preventing browser memory crashes.
  • 📜 Session History: Never lose your data. A built-in IndexedDB database automatically backs up your generated CSVs from past sessions.
  • 📦 Bulk Export Options: Export your metadata as a well-formatted CSV or download all processed images in a single ZIP archive.
  • 🎨 Modern Glassmorphism UI: A beautiful, responsive interface built with Tailwind CSS featuring Dark/Light mode and interactive animations.
  • 🌍 Bilingual Support: Seamlessly toggle between English and Bengali interfaces.
  • 🎯 Custom Generation Rules: Fine-tune maximum title lengths, set exact keyword counts, and dynamically force include or exclude specific keywords.

🛠️ Prerequisites & Setup Guide


To run MetaGen Pro, you will need to host a local AI server using LM Studio. Follow these exact steps to get everything working perfectly:

Step 1 - Install LM Studio & Download a Vision Model

  1. Download and install LM Studio.
  2. Open LM Studio and search for a Vision Model (e.g., qwen2-vl, qwen3.5-vl, or llama-3-vision, llama-joycaption).
  3. Download the model quantization that best fits your hardware capabilities.

Step 2 - Configure the Local Server & Enable CORS (CRITICAL)

For the web browser (MetaGen Pro) to communicate securely with LM Studio, you must enable CORS.

  1. In LM Studio, navigate to the Local Server tab (the <-> icon on the left panel).
  2. Load your downloaded Vision Model into the server at the top.
  3. On the right-side panel, locate the Server Settings section.
  4. Check the box to Enable CORS (Cross-Origin Resource Sharing).
  5. Click Start Server. (By default, it runs on http://localhost:1234/v1).

Step 3 - Install and Configure the App

  1. Download the exe apps from the release and install.
  2. Inside MetaGen Pro, click the Settings (Gear Icon) in the top right corner.
  3. Ensure the LM Studio API URL is correct (usually http://localhost:1234/v1).
  4. (Optional) Enter the exact Model Name if required by your specific setup, otherwise, leave it as default.
  5. Click Save & Close.

💻 How to Use


  1. Auto-Save (Highly Recommended for Large Batches): Click Select Output Folder on the left panel and grant the browser permission. This ensures files are saved to your disk immediately, freeing up RAM for processing thousands of images.
  2. Set Rules: Choose your Generation Mode (Metadata vs. Only Prompt). Set your desired Title length, Keyword count, and any words you want to force include/exclude.
  3. Add Images: Drag and drop your JPEG files into the central workspace.
  4. Generate: Click Generate Data. Watch as the AI analyzes each image, generates precise metadata, and embeds it directly into the files.
  5. Export: Access your CSV files via the Export CSV button, check your History panel, or check your output folder if Auto-Save is enabled!

🛡️ Privacy & Security


MetaGen Pro is a front-end only application. Your images and generated data never leave your computer. All communication happens locally between your web browser and your local LM Studio instance.


👨‍💻 Developed By

Azizul Haque Shaon

About

A powerful offline utility for bulk metadata generation. Designed for artists to automate titles, tags, and descriptions for large batches of images without needing an internet connection.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors