A desktop workbench for NovelAI image generation.
Lay scenes out on a lane, queue them once, and get the whole set.
Website: peropix.mori-mo.com
NovelAI does the generating. PeroPix is the workbench in front of it — and one image at a time is fine until you want twenty of the same character in different scenes. Here you write the parts that stay the same once, line up the parts that change, and send the lot to a queue.
- Scene lane and queue — each scene is a card on a lane. Fill in what differs, queue the lane, and keep working while it runs; every result stays attached to the scene that produced it.
- Prompt blocks — build a prompt out of labelled blocks instead of one long line. Toggle, reorder, and weight them without hunting through commas.
- Card deck — save a style or a character as a card and drop it into any scene. Fix the card once and every scene that uses it follows.
- Wildcards — pools of alternatives that pick themselves at generation time.
- NovelAI's own tools, in the same place — inpainting, enhance, vibe transfer and upscaling run on the scene you already have, with its prompt and settings carried over. No round trip to the website and back.
- Censoring — an on-device model finds the regions and covers them. Nothing leaves your machine; you choose the method and the strength.
- AI assistant — hand it a workspace and describe what you want in words; it edits the prompts and queues the work. It asks before anything it cannot undo.
- A NovelAI subscription and a Persistent API Token. NovelAI makes the images;
PeroPix is the workbench in front of it. Create the token in your NovelAI account
settings — it starts with
pst-. - Generating costs Anlas. Sizes and step counts within your plan's free limits cost nothing, and the generate button always shows the current price before you press it.
- Windows 10 or 11. The WebView2 runtime is required and is usually already there.
- Download
PeroPix-<version>-win64.zipfrom the latest release. - Unzip it somewhere you can write to — your Documents folder, another drive.
Not inside
Program Files. - Run
PeroPix.exe, open Settings ▸ General, and paste your token.
That's it. Python ships inside the package; there is nothing else to install, and nothing is written to the registry. To move or remove PeroPix, move or delete the folder.
You can unzip several copies and run them side by side — each folder keeps its own port, storage and settings. Only opening the same folder twice is blocked.
Everything lives next to PeroPix.exe. Back these up and you have everything;
updates never touch them.
| Folder | What's in it |
|---|---|
workspaces/ |
Your work — tabs, scenes, prompts, and the images under output/ |
gallery/ |
Images you chose to keep |
data/ |
Settings and cards. Your API token lives only in data/secrets.json |
logs/ |
One log file. Attach logs/peropix.log when you report a problem |
app/ is the program itself and is replaced on every update.
PeroPix checks quietly at startup and tells you when a new version is out — or press the button under Settings ▸ Update. It downloads, then restarting applies it. Whether it fetches a small patch or the full package is decided for you; you only see the size.
npm install
npm run tauri dev # frontend (1420) + backend (8770) + windowBackend only: python backend/server.py --port 8770.
Dependencies are in backend/requirements.txt.
Building packages, cutting releases, and how auto-update chooses patch vs. full are described in docs/release.md.
AGPL-3.0-or-later. Bundled third-party components are listed in THIRD-PARTY.md.