Repository navigation
Releases
Kosmozoo v0.5.1
Running Variations on another ComfyUI with no parameter enabled runs each image
once there again, instead of failing with "no valid human-scale permutations";
the destination is one of the compared parameters. The Variations image picker
hides thumbed-down images like the feed, unless they are revealed; images
already chosen stay chosen. The selected source keeps its border while it has
unseen images. These fixes were tested before 0.5.0 but missed it.
Official kosmozoo-linux-x86_64 SHA-256: 3bbde1e20e258ea8aa003478404b08850bc6017ba4aa77b157dfb36edaf88963.
Kosmozoo v0.5.0
Variations can run on any configured ComfyUI, chosen in the dialog and defaulting
to the ComfyUI selected in the header. On another machine, missing nodes and
values outside its model or option lists are listed first in red with up to
three closest replacements, and Run sends nothing until they are resolved. Every
parameter kind recorded in a workflow can be edited, and every run is saved:
recall a saved run's changes onto the current image, or reopen its original
setup with its original images.
Image sets also accept photos from Pexels or any Pexels-compatible service,
added in Settings with keys kept on the engine. The shared image picker shows
loading progress, placeholder tiles and dimmed earlier results while a search
loads; a failed workflow check says which ComfyUI failed and offers Retry.
Images not yet looked at are marked on their source, the navigation rail and the
browser tab icon. Info metadata offers filter actions for parameter values.
Ticked cards are kept per source across page reloads, engine restarts, source
switches and Variations runs. Clicking a file name copies it over plain HTTP too,
and a copy that fails says so.
An engine restart no longer looks like a changed source: an open Variations
dialog keeps working with its edits. Each source's identity is now stored in
the database, so the first start upgrades it (schema 10 to 11). A source added
by 0.4.x after that, if you go back, gets its identity at the next 0.5.0 start.
Official kosmozoo-linux-x86_64 SHA-256: 9443f47244fe57ea0c638ef0691ca70f49ebe97e5430d0ed33e5501c2018dc5f.
Kosmozoo v0.4.1
Header popups stay above feed, selection and workspace controls without changing
feed geometry or scrolling. Runtime identity recovers independently of source
loading and appears in a read-only settings footer, including when search hides
every setting.
Source capabilities recover automatically after discovery failures, membership
changes and engine restarts. Discovery-only updates preserve browsing, selection
and drafts while Delete actions and supported folder controls recover without a
page reload.
The README expands feature coverage and illustrates Variations and face-aligned
comparisons. A new detector guide covers Python installation, model downloads,
service readiness, Web UI connection and API compatibility. Detection remains
optional, externally configured and OFF on each page load.
Official kosmozoo-linux-x86_64 SHA-256: b116a32e4b093d4c422277f37cfdfd3eea85d417158ec03dd409cd3f5025f88c.
Kosmozoo v0.4.0
Still-image comparisons can detect faces, select which boxes to show and choose
an alignment face on each image. Independent, Shared and Face-anchored alignment
share one selector; a cycles alignment and l retains shared movement. Face
anchors align eye midpoints and scale with a shared camera, without rotation or
identity recognition. Multiple faces require an explicit anchor choice.
Detection is optional, requires an externally configured detector service and
starts OFF on every page load. Its separate toggle retains choices while off;
choosing Face-anchored does not enable detection. Detection and displayed pixels
stay bound to the accepted image content, including delayed or failed swaps.
Viewer opacity controls appear only for eligible comparisons. Full, unpaired
and audio views stay opaque while retaining the chosen comparison opacity;
Difference keeps separate base and highlight controls.
Official kosmozoo-linux-x86_64 SHA-256: 8d60550a14a4c40a755acfa89abf723621d3cd03cfafdd9bf4e9a2109d4277b9.
Kosmozoo v0.3.1
Native browser magnification now shows a recovery hint that clears when normal
scale returns. The shared status corner follows the visible viewport while
magnified, keeping its messages reachable during zoom and pan.
Official kosmozoo-linux-x86_64 SHA-256: c65a3e5a2676e843a80e182e6215202cda5ef287ca6fb49c2378e6b1b455aae1.
Kosmozoo v0.3.0
Variations has a compact parameter editor with field-name filtering, independent
node controls, range or single-value inputs, and clearer counts and output-name
previews. Each opening starts a fresh draft; closing with unsent changes asks
before discarding them. Successful runs close after confirmation, while partial
or failed runs keep the draft available. Naming preserves prefixes and suffixes
while keeping long output names within the filename limit.
Build an ordered image set from ComfyUI inputs, any source's outputs, local files
or folders on the engine computer. Drop images onto the panel, drag square tiles
to reorder them, or use each target's current image as its own input. The image
picker has source tabs, searchable thumbnails and scroll-speed-aware lookahead;
failed previews offer an explicit retry.
Play MP4, WebM and MOV videos and FLAC, MP3, Opus and WAV audio in the feed and
viewer, with manual playback, seek, mute and looping. Embedded workflows provide
metadata and Variations for supported media. The viewer opens on the clicked
item in Full view, with video comparison modes and consistent A/B placement.
Zoom stays anchored to the image across navigation and resizing.
The feed filter combines filename, folder, judgments, feedback and parameter
conditions with AND or OR. Scroll the rail with the wheel, follow its alternating
20-tick bands, and hover for image or video-frame previews. New arrivals flash
once, source indicators show unseen images, workflow progress and queue counts,
and incoming items keep the current cards in place. Pinch zoom takes priority
over feed scrolling; media and card controls stay aligned and reachable.
A boot splash and source-loading glimmer provide feedback while content loads.
Shared text fields, buttons, mode switches and action rows bring consistent
focus, hover and active states, with unavailable actions omitted. Copied and
downloaded filenames can optionally include the source name.
Foreground media and metadata take priority over background loading, and the
shown entry gets its metadata independently of collection-wide updates. Byte
ranges support media seeking, failed measurements no longer hide entries, and
large PNG metadata is retained. Source addresses accept an omitted HTTP port,
Variations preserves graph identity and dependencies, and the engine shuts down
promptly with clients connected.
Security hardening validates cache digests, rejects cross-site mutation requests
and serves user media as sandboxed documents. Resource budgets limit metadata
processing and uploads, while packaging checks validate executable inputs.
Official kosmozoo-linux-x86_64 SHA-256: ff2486bfd42f0c50c0e48eb08a52ac9ec8eee826f873629e6e4cad90d0179d34.
Kosmozoo v0.2.2
Fresh installs start with no sources instead of assuming a local ComfyUI server.
The empty feed offers a link to add a ComfyUI host or folder through the source
picker. Explicit KOZMOZOO_HOSTS seeds and existing collections keep their behavior.
Unreachable sources show as offline with one error per outage. Retries continue
quietly, and a successful refresh clears the error and restores online status.
The engine's user service now restarts the engine after a crash.
Executable SHA-256 (kosmozoo-linux-x86_64): 2a1470029a9b50a492a9c59885f0746ca8c95e3c386fe9c72414793aa139a804
Kosmozoo v0.2.1
The README now shows the image feed and comparison workbench in five screenshots.
kosmozoo package-resources --prefix=/usr --destdir=/absolute/package-root
generates desktop, icon, user-service, license, notice and documentation files
for packages without starting services or opening a browser.
Arch users can choose kosmozoo, kosmozoo-bin or kosmozoo-git from the AUR.
Release downloads now contain only the executable and its SHA256SUMS;
project and dependency source links are documented in the licensing guide.
Executable SHA-256 (kosmozoo-linux-x86_64): 87b5f399598c61988f66c016327e189997432c3c4ad6a5102e227d32ca2b55d2
Kosmozoo v0.2.0
Kosmozoo 0.2.0 rewrites the Python v0.1.0 application with a Deno engine and
a Solid client for reviewing and curating ComfyUI image output.
See the README for installation options and features.
Judgments migrate one-way from v0.1.0's feedback.json into per-entry SQLite
records. The original is kept as feedback.json.v1-backup-<ts>; hash-based
judgments fan out to matching entries, and legacy host:filename judgments are
retained as unavailable entries. The export plugin and deno task import-legacy
are removed. State defaults to $XDG_STATE_HOME/kosmozoo (outside the source
tree); the cache uses extension-less content hashes, and KOZMOZOO_DOWNLOADS
is removed. API clients use /api/collections/<id>/entries/* in place of
/api/images/*, collection capabilities for supported operations, and
/api/features/<name>/* for feature routes.
Executable SHA-256 (kosmozoo-linux-x86_64): f8d0b95f104d75d4cb08565b3aab8dcdcc2e69c88b520f7ede162d751fa58f60
v0.1.0 — first public release: ComfyUI image review/curation SPA
2026-08-16
Feature
Header gains a filename filter input: type a substring (case-insensitive,
debounced) to work with a specific set of images; the status line shows
"N of M matching", Esc in the box clears the filter, and a new set scrolls
back to the top. Lightbox pair coupling is now an explicit always-visible
"linked" toggle (default off) instead of being implied by Shift-drag or
face-match alignment.
- Filename filter input in the header (
9eb2cc8) - Lightbox: explicit 'linked' toggle for pair coupling, default off (
489e624)
Fix
Lightbox toggles no longer hide when inapplicable — they grey out instead
(disabled styling, clicks inert), so the toolbar layout stays stable while
browsing. Toggling split-wipe before the new image's dimensions are known
now waits for the dimensions and starts the line at the image's left edge
rather than briefly parking at viewport center.
- Lightbox: toggles always visible, greyed when inapplicable; split
edge-start waits for dims (7b86782)
Refactor
The lightbox was rebuilt as a single-state module: one state object, one
render() that is the only DOM writer, and view state (zoom, pan, flips,
rotation) expressed in box-fraction units so it survives image switches,
flips, and rotations. No user-visible change by itself, but it enabled the
linked toggle and made every later fix cheap.
- Refactor lightbox into single-state module, fraction-unit view state (
5a94f5f)
2026-08-15
Feature
Advanced mode (hamburger menu) landed: a metadata cache with prompt/seed
badges on cards, expandable prompts, group-by-prompt view, and bucket/tag
triage controls whose values are persisted to feedback.json alongside
neg/pos/vote. The lightbox gained H/V flips, Alt+drag rotation with snap
to 0°, a split-wipe compare line, an overlay toggle, and flip buttons in
the chrome synced with the keys. Deployment is friendlier: port 2084 by
default with KOZMOZOO_* env overrides, 0.0.0.0 bind by default, hosts
config-driven via config.json with add/remove from the menu, and a
privacy-preserving batched downloads-check endpoint (no directory listing).
- Advanced mode: metadata cache, prompt expand, group-by-prompt,
bucket/tag, ark (2b18fbc) - Lightbox: H/V flips, Alt+drag rotation, split-wipe, overlay toggle (
615251c) - Lightbox: rotation snap to 0°, wider guide/split grab areas (
ac9dbd4) - Port 2084 default;
KOZMOZOO_PORT/DOWNLOADS/FEEDBACKenv overrides (aed8bfa) - Add/remove hosts from the menu UI (
d334521) - Default bind
0.0.0.0(c9555a4) - Downloads: batched existence check, no directory listing (
6aaff3f) - Flip buttons in the lightbox chrome, synced with H/V keys (
321499a) - Flip buttons sit just above the opacity slider (
6bfbd95) - Lightbox: ANCHOR tag at the slider spot when viewing an anchor (
0b40df8)
Fix
Face detection was hardened: chunk-safe POSTs and never caching failed
detections removed the stale-box poisoning that made faceboxes vanish or
stick to wrong images, and detection now always uploads cached bytes to
the detector instead of asking it to re-read ComfyUI outputs — it works
even when ComfyUI's API is busy generating. Pair-switch view sharing was
restricted to split-wipe mode only, with the underlay tracking pan/zoom
live, and align-no-face falls back to an image recall instead of a
no-op failure.
- Fix facebox poisoning: chunk-safe POSTs, never cache failed detections (
cc74de2) - Detection never touches ComfyUI: candidates upload cached bytes like
anchors (6b4f566) - Pair-switch shares the view only in split-wipe mode; underlay tracks
live (d25cbfb) - Face toggles visible when detection enabled; align no-face falls back
to recall (79ae852)
Refactor
Feedback data moved to a configurable path (menu setting, /api/config,
default ~/Documents/kosmozoo_feedback.json) outside the repo, bucket
names became config-driven, and internal tooling and dead gitignore
entries were dropped from the tree. No user-visible workflow change;
existing feedback files keep working via the configured path.
- Configurable feedback.json path, menu setting,
/api/config(325ad91) - Default feedback path:
~/Documents/kosmozoo_feedback.json(68d8690) - Scrub project-name refs from code; buckets now config-driven (
aed8bfa) - Hosts config-driven via
config.json/KOZMOZOO_HOSTS(8d20f59) - Drop internal tooling from the repo (
d05ba7a) - Drop dead gitignore entry (
2c31283)
Docs
The project went public-ready: LGPL-3.0-only license, a detailed README
with deployment options (direct, systemd, network), the downloads-check
endpoint documented, and a logo with favicon and social card wired into
the README and the app header.
- Add LGPL-3.0 license; gitignore
.envrc(db45203) - Detailed README with deployment options (
3d4fb7b) - Add project logo, social card, app favicon (
fce7070) - Logo size set (64/256/512): README, app header, favicon (
553fbb7) - README: downloads-check endpoint (no listing) (
d54e2fa)
2026-08-14
Feature
First working version: a zero-build single-page app served by a Python
stdlib server that reviews ComfyUI outputs side-by-side — chunked,
windowed candidate grid with a stable anchors pane (persisted, reorderable,
resizable), a draggable resizable splitter, keyboard-driven lightbox
navigation, thumbs/hide flows, neg/pos feedback boxes persisted to
feedback.json, save-to-downloads buttons, and copy-from-above/below to
reuse neighbor prompts. Opt-in face detection (browser model or a local
server-side anime-face worker with 28 landmarks) adds facebox overlays and
"match facebox" lightbox alignment by eye keypoints, a candidate-over-anchor
opacity slider, and linked pan. The day ended with the feedback file
downloading as an exact feedback.json, debounced saving with a visible
"saved" tick, and the app renamed to kosmozoo.
- Initial commit: image review app (
f35300b) - Rename app to kosmozoo (
e049eda) - Add opt-in face detection with lightbox facebox alignment (
bd68b93) - Feedback boxes: 500ms debounce + blur save, saved tick in label row (
f9b1035) - Replace copy/download buttons with exact feedback.json download (
9cfbf01) - Align faces by eye keypoints; draw box + eye dots (
5684a3b) - Add local anime face-detection model, server-side worker (
e1c504f) - Lightbox: facebox visibility toggle + candidate-over-anchor opacity
slider (08e4b17) - Lightbox: linked pan when face-matched or Shift-dragged (
9420ba8)
Fix
Lightbox image switching stopped visibly resetting pan/zoom (stale image
dimensions) and flickering: the incoming image is preloaded and the
outgoing one is covered during the swap. Plain scroll-wheel no longer
pans when zoomed out. Copy-from-above/below now walks to the first
neighbor that actually has feedback content, including hidden ones that
still have stored feedback.
- Fix lightbox switch resetting pan (stale img dims); scroll no longer
pans (f75eae4) - Lightbox: preload before switching images (no load flicker) (
b97fdbc) - Copy from above/below: hidden neighbors contribute stored feedback (
77a7cfa) - Lightbox: cover outgoing image during swap, kill switch blink (
0de79e8) - Copy from above/below walks to first neighbor with content (
8249e90)
Refactor
feedback.json moved out of the repository to a Documents path so curation
data stops polluting the source tree. No user-visible change beyond the
new default location.
- Move feedback.json out of the repo (
2d52eb2)