blob: d196e48da0673f06d985634ec34f6b83928c1df7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
# AGENTS.md
Guidance for AI coding agents working in this repository.
## What this is
`upscale-qt`: single-file PyQt6 desktop app (`upscale-qt`, no `.py`
extension) to upscale an image with an ESRGAN model through `sd-cli`
(stable-diffusion.cpp), compare before/after with a slider wipe, then save
as a new file or overwrite the original. A small vision model (imajev, run
one-shot through `llama-mtmd-cli`) suggests which upscaler to use. The only
Python dependency is PyQt6; everything else is stdlib plus the two external
binaries. Keep it a single file and do not add dependencies.
Design spec: `docs/superpowers/specs/2026-10-30-upscale-qt-design.md`.
## External tools
- Upscale: `sd-cli -M upscale --upscale-model <model> -i <in> -o <out.png>`.
Models are `.pth`/`.safetensors`/`.gguf` files in the upscalers dir.
- Suggestion: `llama-mtmd-cli -m <imajev gguf> --mmproj <mmproj gguf>
--image <in> -p <prompt>`. Its answer is free text and gets matched to a
filename from the upscalers dir; never trust it as a path.
- Both run through `QProcess` so the UI never blocks.
## Conventions
- Images are held in a list of jobs internally even though the UI shows one
at a time, so batch mode can be added without a rewrite.
- Non-GUI logic lives in module-level functions so it can be tested without
a display.
- Overwrite always asks for confirmation and keeps the original's format.
- Placeholders only in code, docs, tests and commits.
## Testing
No test suite yet.
## Repo facts
- License: GPLv2 only (`LICENSE`, header in each source file).
- Work directly on master.
|
