Skip to content
Chris Mattmann edited this page Sep 5, 2026 · 2 revisions

Command line

bin/imagecat is the operator command. It lives in the tarball. After unpack:

export IMAGECAT_HOME=/path/to/imagecat
. $IMAGECAT_HOME/bin/setenv.sh
$IMAGECAT_HOME/bin/imagecat help
Command What it does
imagecat setup Create $IMAGECAT_HOME/.venv (OCR, CLIP, Keras Lens) and build the ImageSpace Vue UI. Same as bin/imagecat-setup.
imagecat start Start File Manager, Workflow, Resource Manager, Tomcat, Solr, and ImageSpace. Wraps bin/oodt start for this tree only.
imagecat stop Stop those same processes.
imagecat index <dir> [dir...] Copy JPG / JPEG files into $IMAGECAT_HOME/data/staging/images/<folder>/, keep nested paths (so duplicate Pic 1.jpg names survive), chunk, OCR, Jaccard, CLIP, fg/bg. Adds to the catalog. --no-wait submits and returns.
imagecat status Solr imagecat / oodt-fm counts, ImageSpace capabilities (search / similar / lens / fgbg / meta), running or last task, .progress.
imagecat reset [--yes] [--lenses] Empty workflow instances, Solr cores imagecat and oodt-fm, data/archive, data/jobs, and CLIP / fg / bg / thumbs / meta. Staging stays. Lenses stay unless --lenses. --yes skips the [yN] prompt. Refuses while something is PGE EXEC.
imagecat check Compare ChunkList paths to Solr; print Num Missed and any *_missed.txt.
imagecat help Print this command list.

JPGs only. Do not flatten trees whose basenames collide.

Walkthroughs: Installation (setup, start), How to Run (index, status), Re-running (reset), Check for Failed Ingestions (check).

bin/chunker, bin/oodt, and wmgr-client --dynWorkflow remain as low-level tools. You do not need them for a normal ingest.

ImageCat Wiki

ImageCat — ingest, OCR, search.

Source and issues

Start here

Operate

Old

Retired install paths (Docker-as-install) live under Old. Original URLs still resolve via stubs.

Clone this wiki locally