whatisgithub

What is visionary?

prometheus-000/visionary — explained in plain English

Analysis updated 2026-07-25

2PythonAudience · dataComplexity · 3/5Setup · moderate

In one sentence

A desktop app that helps you build clean image training datasets on your own machine. Browse, group, tag, caption, and export images for training AI models, all locally with no data leaving your computer.

Mindmap

mindmap
  root((repo))
    What it does
      Cull and curate images
      Tag and caption images
      Export training datasets
    Tech stack
      Python
      SQLite
      macOS Apple Silicon
    Use cases
      Build training datasets
      Find and remove duplicates
      Generate captions locally
    Audience
      Dataset builders
      AI model trainers
      Privacy-focused users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Browse a folder of images and delete unwanted shots to the system Trash.

USE CASE 2

Group near-duplicate images and keep only the highest-resolution copy.

USE CASE 3

Generate keyword tags and descriptive captions for images using local AI models.

USE CASE 4

Export a ready-to-train dataset with caption files and converted JPEGs to a remote machine via SSH.

What is it built with?

PythonSQLiteApple Silicon

How does it compare?

prometheus-000/visionary0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedatageneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.11+ and a tool like uv or pipx to install, runs best on macOS Apple Silicon with experimental Linux support.

So what is it?

Visionary is a desktop application for building image training datasets entirely on your own machine. It guides you through a workflow: ingest images from a folder, cull the ones you don't want, group similar shots together, tag them, write captions, and export a clean dataset ready for AI model training. The developer describes it as sitting between a file browser like Adobe Bridge and a training tool, focused on the curation step rather than editing or training. It is currently in alpha, runs from source, and is built primarily for macOS on Apple Silicon, with experimental Linux support and untested Windows compatibility. To install it, you need Python 3.11 or newer. The recommended approach uses a tool called uv or pipx to create an isolated install that puts a visionary command on your system. You then run that command and open a folder of images. Visionary scans your files into a local SQLite index stored in a hidden .visionary folder alongside your images. It computes thumbnails and visual features in the background while you browse. Your original image files are never modified. The grid view offers six arrangement modes: by visual structure, color, person, resolution, filename, or file size. You select images with clicks and keyboard shortcuts familiar from file browsers, then delete unwanted shots to the system Trash. A deduplication feature finds near-duplicate groups and marks all but the highest-resolution copy for review, while exact duplicates can be removed automatically. On macOS, a face detection tool groups images by person using on-device recognition, and nothing leaves your machine. Captioning is a central feature. Taggers append keyword-style tags to each image's caption text without overwriting what exists. Vision language models write descriptive prose, with a built-in offline describer that needs no download and optional larger models like JoyCaption Alpha Two, Moondream 2, and Qwen2.5-VL. You can combine taggers and captioners for hybrid captions. The training section inserts a trigger word into captions, and export packages everything as a flat folder with .txt sidecars or a metadata.jsonl file, converting formats like HEIC and RAW to JPEG so training tools can read them. You can also push the packaged dataset to a remote machine via SSH. Captions and tags are stored in .txt files next to each image, keeping datasets portable. Visionary does not watch the filesystem for changes, you press a refresh button to reconcile any external modifications. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me install and run Visionary on my Mac using uv, and guide me through opening a folder of images to start curating a dataset.
Prompt 2
I have a folder of RAW photos. Walk me through using Visionary to find duplicates, tag images, generate captions, and export a training dataset as metadata.jsonl.
Prompt 3
Explain how to combine Visionary's offline tagger with a vision language model like JoyCaption Alpha Two to create hybrid captions for my image dataset.
Prompt 4
Show me how to configure Visionary to export my curated dataset and push it to a remote training machine via SSH.

Frequently asked questions

What is visionary?

A desktop app that helps you build clean image training datasets on your own machine. Browse, group, tag, caption, and export images for training AI models, all locally with no data leaving your computer.

What language is visionary written in?

Mainly Python. The stack also includes Python, SQLite, Apple Silicon.

How hard is visionary to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is visionary for?

Mainly data.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.