Repository navigation
Releases
Sprite H3 v0.1.1 (alpha)
A fix release after the first desktop pass of v0.1.0, plus one change to how a run is
prepared. Workspaces, slots and builds are read as they are; the catalog's job table gained a
column, so the first launch rebuilds the state database and re-indexes runs from disk (see the
upgrade note).
What's new
The dry run is a contract. Generate now submits the dry run it was gated on and runs
exactly the inputs that dry run prepared: the same staged pictures, byte for byte, the same
prompt, seed and workflow. What you inspected is what runs. A dry run that no longer matches
the character (a source replaced, a cell not rehearsed, another workflow) is refused with a
clear message and the button reads Dry run again. One a queued run names cannot be deleted;
older dry runs of a character go when a newer one completes, and a consumed one when its run
ends, so they no longer pile up under runs/.
Prepared inputs, in the drawer. After the dry run the drawer shows what it prepared: per
cell the staged picture ComfyUI receives, the seed, 107f @ 24 = 4.458 s, the resolved prompt
and a download of the request graph; above them the workflow and its hash, the FFmpeg version
and the run directory with Copy. No more opening the run folder to read the prompt. The dry
run also probes FFmpeg now, as a real run does, so a missing FFmpeg surfaces before GPU time.
One button before Generate. Save & dry run saves, validates and rehearses in one click;
validation errors stop it with their rows as before. The gate reads Prepare & inspect ›
Generate, and a reload keeps it.
Replacing a source with runs in flight. A run already submitted keeps the picture it
captured, queued or running. When live runs still carry the previous picture, replacing a
facing asks once whether to stop them; their cells are free to tick again once they stop.
Every job also captures each facing once, under the character's write lock, so one run can
never mix two revisions of a source.
Generate from the compare sheet. Cells on a compare view tick like matrix cells, the action
name on a row header ticks the row's missing facings (the whole row when nothing is missing), a
facing header ticks its column the same way and the corner ticks every missing cell; a click
replaces the ticks, Shift adds a line, and a second click on a ticked line unticks it, as the
headers on the character page do (transposed, the facing row headers do the same). The remove
cross of a row sits apart from the tick and shows on hover. The pill at the bottom opens the same generate drawer the character page has, with its gate chain, receipt and
Dry run / Generate. A run is one character: the pill names which character goes
first, the other characters' ticks stay for the next click, and the job dock sits under the
sheet so the queue is visible where it was started. The drawer's chips and the sheet's ticks
are one selection: removing a chip unticks the cell, reopening the drawer keeps it removed,
and a submission drops exactly the cells it carried. The per-cell Generate / Retry link to
the character page stays for a single cell.
One unsaved compare view, and you can see it. A workspace keeps one unsaved compare view,
and the roster now shows it as an Unsaved · 3 rows chip beside the saved views, so it is a
click away like they are. + New view starts empty: when a draft with rows exists it asks once
and discards it on your say-so. The compare page has Discard… next to Save view…, and a
view opened from a template action on the roster is not the draft until you change something,
so browsing those links no longer replaces what you were building. Removing the last row
clears the draft.
Custom prompt editor, back. v0.0.1 let you replace an action's composed prompt with your
own text; the redesign lost the editor while the override itself survived in the files. It
lives in the drawer's per-action Prompt preview again: Write your own starts from the
composed text of the picked facing, the diff under the editor mutes what the composer already
said and marks what you added or removed, Reset to composed drops it, and an empty override
is flagged before validation refuses it. One override per action, sent verbatim for every
facing, saved with any other edit.
Restore a removed template action. A character that dropped one of its template's actions
gets it back from Add action › Restore a template action…; the row menu no longer lets a
character lose its last action. A removal now stays removed: the template can drop the action
and offer it again, the character can be saved in between, and the action stays out until you
restore it.
Jobs name their character. The dock reads Generating walk · right · fighter · 1 of 3 and
a folded card fighter: walk · right, so a queue across several characters reads apart. The API
resource carries project_name beside project_id.
The gate knows when ComfyUI is down. The dry run works without a GPU, and still does;
Generate now stays blocked while the ComfyUI badge is red, the drawer's chip reads ComfyUI
unavailable instead of ready to generate, and the confirm says so when the backend is down
or has not been checked yet. Before, a run submitted against an unreachable ComfyUI failed ten
seconds later with a clean failure card, which is a poor way to learn it.
Small things that read better. The draft counter spells out 8 selected + 4 waived of 16
slots instead of a 12 that already held the waived ones. Removing an action from a template
that has characters asks first and says what leaves their matrices (nothing is deleted; adding
it back restores the row). The action store drawer closes after an add on templates as it does
on characters, and adding several entries reports them all. Deleting a character names its
frozen builds among what goes.
Fixes since v0.1.0
- Replace…, Add source… and Remove on the Settings tab were disabled while any generation
ran anywhere in the workspace. They are locked only while an upload of this character is in
flight; runs already submitted keep the picture they captured (see above). - A replaced facing source kept showing the old picture in the character header and on the
roster until a hard reload (the settings card was the only place that refreshed). Every
source picture now carries a revision, and the artifact route sendsCache-Control: no-cache
so an unversioned picture revalidates against its ETag. - + New view on the roster reopened the last unsaved compare view instead of an empty page,
nothing could clear that view short of removing its rows one by one, and opening an action
from the readiness grid silently replaced it. See One unsaved compare view above. - A character's removed template action came back on its own: once the template dropped the
action, one unrelated save of the character forgot the removal, and the action returned with
the template. The marker now survives both. - A dry run could stay on the job dock as a finished generation, Ready to review, after the
drawer moved on to another character. The dock now drops a dry run once it is done and
calls it a dry run while it runs. - The compare sheet's generate drawer inherited the busy cells of whichever character was
open on the matrix before, so a cell of character B could be silently dropped from the
drawer because character A had a job on the same action and facing. - The roster card said generating 0 of 1 clip from submission to the end of a one-clip run,
and generating while the job was still queued. It now names the work: queued: walk ·
right, generating walk · right, 3 clips queued, generating 3 clips, 1 done. - The workspace defaults the wizard's step 2 and the Settings page collect were written to
workspace.tomland never read: New template… started from thedefaulttemplate. It now
starts from the defaults (cell, figure, canvas, key colour); a copy keeps its source's values.
The wizard and the Settings page also store the baseline Recommend from cell computes next to
the figure ratio instead of a fixed 0.88. - An unknown character id (
/w/<ws>/c/prj_nope) sat on a skeleton for ever. It now says No
character with the id … in this workspace with Retry and a way back to the roster, like the
workspace and template routes do. - The Runs tab and its count only caught up with a finished run after a reload; they follow a
run to its end now, failed or not, on every tab. - Unwaive on a slot with no frames could never be saved, and the blocking message did not say
that Clear selection is the way to drop the waiver. It does now. - Job progress arrived as raw floats (
55.00000000000001) in the event stream; it is rounded
once at the source, so the job record and the stream agree. - A waived matrix cell announced its live Slot link and Retry as disabled to assistive
technology. - The roster subtitle pluralises (1 character), and the compare page offers the prop column
only when a row is a prop.
Known gaps
Unchanged from v0.1.0, plus:
- The compare sheet queues the ticks of other characters for the next click rather than
submitting several runs in one go. - Cells a live job holds are not greyed on the compare sheet the way they are on the matrix;
the drawer leaves them out. - A dry run is not a run: the roster card ignores it by design; the dock shows it only while
it prepares. - The offer to stop runs that carry a replaced source only sees the jobs this window's dock
knows about; a run queued from another window is not counted.
Upgrade note
Install v0.1.1 over v0.1.0 and launch. The first launch rebuilds the state database (the job
table changed) and re-indexes every run from disk: the job history of past sessions is gone,
ru...
Sprite H3 v0.1.0 (alpha)
The first release of the redesign around Character Builds: every character has a matrix of
actions × facings, each cell is a slot you fill with frames from any run, and Freeze packs the
slots into a hashed, immutable build. Still an alpha: unsigned Windows installer, catalog
rebuilt on first launch, no engine adapters.
Before you upgrade from v0.0.1: back up
%AppData%\app.sprite-h3.desktop\and write
down any custom motions you added to the motion store. The catalog is rebuilt on first launch
and the motion store does not survive it (see Breaking changes).
What's new
Character page with a Build matrix. Actions × facings on one page, each cell a preview
strip that plays as a loop or lays out as a sheet, all matrices on one clock. Tabs for Settings
(sources, identity, actions, geometry, key colour), Runs and Builds. The separate Generation
page is gone: tick cells in the matrix, click a row or column header to tick the line, the
corner for everything missing, and a Generate N cells button opens a drawer with one editor
block per action, the gate chain and the request receipt before you submit. Ticking a cell of
a disabled action enables the action on validate.
Slots: pick frames from any run. Open a cell to see every candidate clip of that action and
facing across all runs of the character, use a whole clip, a review curation, or hand-pick
frames. Picks are pinned by content hash. The review page can write the slot directly (Save
and use in slot), so a fresh clip goes from review into the matrix in one step. A slot whose
frames disappear reads broken; a slot whose character geometry changed reads stale with a
reprocess offer; a slot you leave empty on purpose can be waived.
Freeze and builds. Freeze packs the current slots into a numbered build: per-action and
per-facing sprite sheets with metadata and contact sheets, copied frames, and a
character-build/1 manifest that hashes every file. Missing or stale slots are recorded as
skipped, not refused. Builds download as archives from the Builds tab; every file is re-hashed
against the manifest before an archive is served.
Stable action identity. Actions carry an id fixed at creation and inherited from the
template, so renaming an action keeps every run, override and slot attached. Runs from before
ids existed are matched by name; leftovers appear in an Unassigned row with Assign to…,
which writes a per-character alias file. Runs are never edited.
Templates that propagate. Template actions reach characters at load time instead of by
copy, so a template change shows on every character on the next load. Character overrides
shadow single fields.
Roster. All characters of a workspace grouped by template, each with its readiness per
template action, its newest build, archived characters included. A Check workspace button on
the workspace settings page lists characters of one template that disagree on cell size, feet
row or timing (warnings only; nothing is blocked).
Compare and views. Build a view of (character, action) rows and watch them play in lockstep
at normalized time, with a facing filter, hide-empty and transpose. Views are saved as files in
the workspace and listed on the roster. Same action across characters fills a view from a
roster column.
Downloads. Build archives per character, a newest-builds archive for the roster, a view as a
contact sheet, the preview strips of a view as a zip, per-run packs from the Runs tab. Every
download goes through the native save picker where the WebView offers one (the desktop app
does), a plain download otherwise.
Reference-aware delete and slim. Deleting or slimming a run lists the slots that stand on it
and asks once. Slim keeps the raw frames, curations, packed products and the preview strips, so
a slimmed cell still plays in the matrix.
Published contracts. JSON schemas for sheet-v3, character-build-v1, slot-v1 and
view-v1 plus the HTTP API as openapi.json under contracts/, generated from the models and
checked by a test.
Fixes since v0.0.1
- Row and column packs send the saved project geometry, so a cell resized after generation
packs at its current size instead of failing on the run snapshot (#1). - Key-colour warnings run the real key/alpha round trip with the project's matte and
thresholds; the panel shows the staged reference with a damage mask and names the matte (#2).
Distance is the default matte. - Review key quality uses the recorded matte, minimum alpha, chroma tolerance and alpha power
rather than the distance defaults, and reports which matte it measured with. - Switching facings no longer shows the previous facing's staged reference or mask.
- Slot reorder, verdict, strip, region, suggestion, warning and receipt glyphs are icons;
WebView2 dropped the unicode symbols. - ComfyUI prompts are cancelled on timeout and transport failure, not only on user stop.
- Template import bounds ZIP entry count and declared expansion before reading any member.
- Run identity is (workspace, run directory); two workspaces can hold runs with the same
directory name. Run ids keep their case throughout. - Missing left/right facings are no longer described as mirrored at export.
- Tagged builds stamp the version into the Python package and the desktop shell together, and
the release workflow verifies the packaged sidecar reports it. - Creating a character no longer ranks key colours on every upload; four sources upload in
parallel and the dialog closes in well under a second instead of 20–30 s. - A wide source that does not fit the canvas at the template's figure height is staged at the
largest ratio that fits and reported as a warning that offers the fitting ratio with one click, instead of
failing the key check and the run. - The generate gate's dry run no longer shows up as a completed run or counts as one; a
show dry runs toggle lists them for deletion. - The job dock keeps the running job pinned at the top and never evicts it behind a long
queue; queued and finished jobs collapse to one line each, and a run in progress is visible
after navigating to the character in-app, not only after a full reload. - Export build is disabled while a freeze runs, so it cannot hand out the previous build
during the eight seconds the new one takes. - The new-workspace wizard uses the real template editor, staged: actions, motions and geometry
are set before anything reaches disk, and Cancel leaves nothing behind. - Two concurrent first scans of a fresh workspace no longer race on the catalog's unique index
(a 500 on the workspace check). - The stray
runs/folder under the app-data directory is no longer created; runs live under
their workspace.
Breaking changes
- The catalog is rebuilt on first launch. There is no migration in the alpha. Job history
and custom motions in the motion store are lost; built-in motions are reseeded. Motions
that live in template or character files (motions/<action>.txt) are files and stay. - Action ids are written into project and template TOML on save. A file without ids still
loads; the id is derived from the name once and written back on the next save. Motion files
of actions are named by id from now on. - New directories under each character:
build/slots/,build/aliases.jsonand
build/<NNNN>/for frozen builds. Views live inviews/under the workspace. Archiving a
character now writes an emptyarchivedmarker file beside itsproject.toml, so the state
survives the catalog rebuild; archived characters are read-only and stay on the roster. - Run manifests record the project id and the action id of every cell. Existing runs are
matched by character name and action name. A run whose character name is shared by two
characters stays detached and shows under neither (see Known gaps). - Sheet format 3.
sheet.jsonrecords the run, cell, processing revision and frame index of
every packed frame. Packs made by v0.0.1 are left as they are; every new pack and every build
writes format 3. - The Generation, Review and Export pages are gone. Their addresses redirect to the roster
or the last opened character. Generation lives in the drawer and the Settings tab; review
opens from a run's cell; export is the Builds tab, the Runs tab and the roster menu. The
composed-versus-verbatim prompt diff has no UI; the drawer shows the verbatim override as text.
Known gaps
- Mirroring a facing from its opposite is not available; generate all four facings or waive.
- No detach from template for an inherited action; override fields instead.
- No UI for archive, import, rescan or deleting a workspace.
- A template can be copied from another workspace only in the new-workspace wizard; for an
existing workspace copy the template folder on disk, the list rescans. - No way to attach a detached run (one recorded before ids whose character name is not unique
in the workspace) to a character. Give the characters distinct names before upgrading, or
regenerate. - Exports run to completion; a large contact sheet or strips zip cannot be cancelled.
- The local API has no credential; anything on the same machine can talk to it on loopback.
- Windows only; the installer is unsigned and SmartScreen warns on first run. Verify the
download with the checksum and the attestation as the README describes. - Browser end-to-end tests do not run in CI; the desktop pass before this release was manual.
Upgrade note
- Quit Sprite H3 and back up
%AppData%\app.sprite-h3.desktop\(config, workflows,
workspaces, catalog). - Note down custom motions from the motion store; they are not carried over.
- Install v0.1.0 over the old version and launch. The catalog rebuilds ...