Skip to main content

​
Supported formats

​
Project data

Projects live at Documents/Koharu/<project-name>.khrproj/. Each contains alternating durable state files and content-addressed blobs for source images, generated artwork, and authored raster edits.
Do not change internal project files while the project is open. Deletion from the project browser permanently removes the complete directory.

​
Settings and credentials

Non-secret typed settings live in ~/.koharu/config.toml, with sections owned by pipeline, translation providers, typesetting, and Agent. Missing settings use defaults. Invalid manual edits can prevent initialization; use the Settings UI. Provider credentials use the operating system’s secure credential service. A project backup does not include provider keys or the Agent account session.

​
Runtime and model cache

Packages are stored at <cache>/koharu/packages/ under the operating system cache directory. This data is replaceable: removing it while Koharu is closed causes the required packages to download again. Never remove a package while the desktop process may still have a native library loaded.

​
Back up safely

1

Close the project

Finish current work before copying its files.
2

Copy the entire directory

Keep the state files and blobs together. A PSD export is not a project backup.
3

Save settings separately

Copy config.toml if needed. Reconfigure credentials through Koharu on the restored machine.