Edit photos by describing the change, on your own GPU. A free, open-source alternative to Nano Banana and ChatGPT image editing: photos stay on your computer, no daily limit. One installer for Windows, Mac and Linux sets up the best open model (Qwen-Image 2.1). MCP server for AI agents.
TypeScript ai-photo-editorcomfyui-alternativegenerative-fillimage-editingimage-generationinpaintinglinuxlocal-aimacosmcpmcp-servernano-banana-alternativeofflinephoto-editorprivacyqwen-imageqwen-image-2-1stable-diffusion-cppvulkanwindows
STATUS and release notes for 0.10.2
Gabriele Lozupone92e464bff8a9
diff --git a/docs/STATUS.md b/docs/STATUS.mdindex 98e0787..e2c0300 100644--- a/docs/STATUS.md+++ b/docs/STATUS.md@@ -1,6 +1,6 @@# Status-**Updated 2026-10-22.** What is in progress, what comes next, and where help is welcome. Kept current at the end+**Updated 2026-10-23.** What is in progress, what comes next, and where help is welcome. Kept current at the endof every task (see [AGENTS.md](../AGENTS.md#keeping-docsstatusmd-current)); GitHub is the source of truth.## Current version: [0.10.1](https://github.com/GabrieleLozupone/kokon/releases/tag/v0.10.1) (2026-10-22)@@ -16,6 +16,20 @@ Tracked in [#15](https://github.com/GabrieleLozupone/kokon/issues/15); design in- A Docker image for NVIDIA (CUDA) first; an AMD/Intel (Vulkan) image once it can be tested.- Later: the desktop app as a client of a Kokon server elsewhere.+## Being tested: 0.10.2 (branch `release-0.10.2`)++Notes: [release-notes-0.10.2.md](../marketing/release-notes-0.10.2.md). Tested on Windows (CUDA); macOS and+Linux next.+- **New image from reference images**: with New image, the images you add are references (a person, a+ product, a style) for a new picture sized by your quality and aspect ratio, not by image 1; Prompt+ has its+ own instructions for it. Also in MCP (`generate_image` with `reference_images`) and the HTTP API.+- **Prompt+ menu**: off, write and make, or write the prompt into the box first to read and change it.+- **Longer Prompt+ prompts** for crowded scenes (they were cut at 512 tokens).+- **Edits never reuse their source's seed** (that made them over-sharpened and crunchy).+- **Vulkan decodes in 512 px tiles**, under AMD's 2 GiB buffer limit (decodes took 25-70 s on AMD cards).+- **New engine** [kokon-1013-1814814](https://github.com/GabrieleLozupone/stable-diffusion.cpp/releases/tag/kokon-1013-1814814)+ (upstream fd21ecf, with the Vulkan fix for cards without Resizable BAR).+## Next- **0.12: reliability foundations** (details soon).@@ -25,8 +39,11 @@ Tracked in [#15](https://github.com/GabrieleLozupone/kokon/issues/15); design in## Known issues-- **AMD RX 6000 (RDNA2) cards are slow on Vulkan** (an RX 6700 XT took ~21 s per step). Under investigation;- flash attention on cards without matrix cores is the main suspect. RX 7900 XTX and RX 9060 XT work well.+- **AMD RX 6000 (RDNA2) cards are slow on Vulkan** (an RX 6700 XT takes 21-41 s per step at 1 MP). Under+ investigation: flash attention and memory placement are ruled out (the model stays in VRAM, the GPU is at 99 %).+ RX 7900 XTX and RX 9060 XT work well.+- **Slow VAE decode on AMD cards on Vulkan**: the decode asks for a buffer over the driver's 2 GiB limit and takes+ 25-70 s instead of a few seconds. Fixed in 0.10.2.- **LoRA is beta** and tested on Windows only; reports from macOS and Linux are welcome([#33](https://github.com/GabrieleLozupone/kokon/issues/33) has a product-shot test).- **Macs are slow** compared with NVIDIA cards (about 4 minutes for 1 MP on an M2 Pro 16 GB). Engine speed-ups are@@ -44,6 +61,8 @@ Tracked in [#15](https://github.com/GabrieleLozupone/kokon/issues/15); design in- Good first issues: [#2](https://github.com/GabrieleLozupone/kokon/issues/2) gallery keyboard,[#3](https://github.com/GabrieleLozupone/kokon/issues/3) site slider keyboard,[#4](https://github.com/GabrieleLozupone/kokon/issues/4) reduced-motion video.+- AMD RDNA3/RDNA4 owners who know HIP: compare a ROCm engine with Vulkan+ ([#38](https://github.com/GabrieleLozupone/kokon/issues/38)).- Hardware reports: AMD and Intel on Windows and Linux, Linux on NVIDIA outside WSL, Macs other than an M2 Pro.- Model proposals that meet the switch rule: [Discussion #35](https://github.com/GabrieleLozupone/kokon/discussions/35).diff --git a/marketing/release-notes-0.10.2.md b/marketing/release-notes-0.10.2.mdnew file mode 100644index 0000000..ce82b70--- /dev/null+++ b/marketing/release-notes-0.10.2.md@@ -0,0 +1,39 @@+## Kokon 0.10.2++A new engine, new images from reference images, and cleaner edits.++- **New image from reference images**: with New image, the images you add are now references (a person, a product, a style) for a new picture. Its size comes from your quality and aspect ratio, not from the first image, and Prompt+ writes the prompt with that in mind. Also in MCP (`generate_image` with `reference_images`) and the [HTTP API](https://github.com/GabrieleLozupone/kokon/blob/master/docs/http-api.md).+- **Read the prompt before it runs**: the Prompt+ menu has three choices: off, write and make, or write the prompt into the box so you can read and change it first.+- **Longer Prompt+ prompts** for crowded scenes: they were cut at 512 tokens.+- **Cleaner edits**: an edit made with the same seed as the image it starts from could come out over-sharpened and crunchy, and often ignored the instruction. Kokon now picks another seed in that case and tells you why. MCP tools tell agents not to reuse the source's seed.+- **Faster decoding on AMD and Intel cards (Vulkan)**: the last step of every image, the VAE decode, could take 25-70 s on AMD cards, because it asked for more memory in one piece than the driver allows (2 GiB). With Vulkan, Kokon now decodes in tiles of 512 px, which takes a few seconds. Settings → Diagnostics shows the tile size the engine uses.+- **New engine** ([kokon-1013-1814814](https://github.com/GabrieleLozupone/stable-diffusion.cpp/releases/tag/kokon-1013-1814814)): Kokon's engine now follows stable-diffusion.cpp up to fd21ecf. It includes a Vulkan fix for AMD and Intel cards without Resizable BAR (SAM on AMD): the engine could put the model in system memory instead of on the card, which makes every step much slower. If your AMD or Intel card was slow on Vulkan, please try again and tell us your seconds per step.+- `kokon-mcp --help` ([#36](https://github.com/GabrieleLozupone/kokon/pull/36)).+- For developers: every route of the local HTTP API is documented in [http-api.md](https://github.com/GabrieleLozupone/kokon/blob/master/docs/http-api.md), with a macOS `curl` example ([#37](https://github.com/GabrieleLozupone/kokon/pull/37)).++**Updating from 0.10.x**: the app updates, then downloads the new engine once (about 345 MB with an NVIDIA card, 30 MB with Vulkan or on a Mac). The models stay as they are. Your images and settings are kept.++On macOS, if the first launch only says **The application "Kokon" can't be opened**, with just an OK button and no *Open Anyway* in System Settings, run `xattr -dr com.apple.quarantine /Applications/Kokon.app` in Terminal, then open Kokon. Details in the [README](https://github.com/GabrieleLozupone/kokon#macos-says-kokon-cannot-be-opened).++### Installing on Linux++```bash+sudo apt install ./Kokon_0.10.2_amd64.deb # Ubuntu 22.04+, Debian 12+, Mint 21++sudo dnf install ./Kokon-0.10.2-1.x86_64.rpm # Fedora 40++```++NVIDIA cards need the proprietary driver (the CUDA runtime comes with Kokon). AMD and Intel cards use Mesa's Vulkan driver.++### Thanks++- @shrinivas-sn, for `kokon-mcp --help` (#36) and the HTTP API reference (#37).+- Solembumm3 on Reddit, for the RX 6700 XT logs that led to the Vulkan fix.++### Downloads++| File | SHA-256 |+|---|---|+| `Kokon_0.10.2_x64-setup.exe` (Windows) | `TODO` |+| `Kokon_0.10.2_aarch64.dmg` (Mac, macOS 15+) | `TODO` |+| `Kokon_0.10.2_amd64.deb` (Ubuntu, Debian, Mint) | `TODO` |+| `Kokon-0.10.2-1.x86_64.rpm` (Fedora) | `TODO` |