What do you want to do?
4 use cases
-
Edit a photo by describing the change in plain words
Install Kokon, let it set up models, then type an edit like 'make it golden hour' and get the result locally.
View prompt
Use the Kokon app on this machine to edit the photo at <photo path> with the instruction '<edit description>'. Save the result next to the original and report the output file path. Check that the output has the same width, height and aspect ratio as the input photo.
-
Let an AI agent create and edit images on your machine
Connect Claude or Cursor to Kokon's built-in MCP server so the agent can generate and edit images locally.
- Kokon
- Claude Code
- Cursor
- Content
- Advanced
View prompt
Using the Kokon MCP server in this repo (GabrieleLozupone/kokon), edit the image at <image path> with the instruction '<edit description>' and save the result to <output folder>. Expected output: the path of the new image file. Verify that the file exists and that its dimensions match the source image.
-
Remove or replace one object without touching the rest
Paint over an area, pick Remove or Replace, and let the model edit only that region.
View prompt
In the Kokon app, remove the object at the painted area of <photo path> and save the result as <output path>. Expected output: a new image file with the same size as the source. Verify by comparing the unpainted parts of the source and result images to confirm they are unchanged.
-
Upscale and color-grade a result for final delivery
Take a generated or edited image to 2x, 4K or a custom width, then apply a LUT look.
View prompt
Using the Kokon app, upscale the image at <image path> to <target width> pixels wide and apply the color look <LUT name or .cube path>. Expected output: a saved image file at <output path>. Verify that the output width equals the target width.
How to use Kokon
- Check you have what it needs: Windows 10 64-bit or later, an Apple M1 or newer Mac on macOS 15 or later, or x86-64 Linux; A graphics card with 12 GB VRAM or more (NVIDIA recommended), or an Apple Silicon Mac with 16 GB unified memory or more; 15 GB of free disk space (25 GB recommended) and about 12 GB of model downloads on first run.
- Open GabrieleLozupone/kokon on GitHub and read the README and license.
- Download the installer for your system from the latest release on the Kokon GitHub page (Windows: the x64 setup .exe; Mac: the Apple Silicon .dmg in beta; Linux: the .deb or .rpm in beta).
- Run the installer. On Windows it installs for your user only, so administrator rights are not needed.
- On first launch, let Kokon detect your graphics card or Mac memory, accept the recommended preset and wait for the model download to finish and verify.
- Drop or paste a photo into Kokon.
These steps come from our top use case, Edit a photo by describing the change in plain words, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forPhotographers, designers and hobbyists who want to change photos by describing the edit, and people whose AI agent needs to create or edit images without a cloud service.
- Why it is hot
- LanguageRust
- Sourcegithub.com/GabrieleLozupone/kokon · Back to Hot repos
Requirements
- Windows 10 64-bit or later, an Apple M1 or newer Mac on macOS 15 or later, or x86-64 Linux
- A graphics card with 12 GB VRAM or more (NVIDIA recommended), or an Apple Silicon Mac with 16 GB unified memory or more
- 15 GB of free disk space (25 GB recommended) and about 12 GB of model downloads on first run
- A photo to edit, or a sentence describing the image to create
Maintain Kokon? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/gabrielelozupone-kokon/?ref=badge)
Questions about Kokon
What is Kokon?
Kokon is a free, open source desktop app that edits and creates photos from text descriptions on your own GPU or Mac, powered by Qwen-Image 2.1, with an MCP server for AI agents. It is an open-source project on GitHub: https://github.com/GabrieleLozupone/kokon.
Who is Kokon for?
Photographers, designers and hobbyists who want to change photos by describing the edit, and people whose AI agent needs to create or edit images without a cloud service.
What can I do with Kokon?
4 use cases so far, for example: Edit a photo by describing the change in plain words; Let an AI agent create and edit images on your machine; Remove or replace one object without touching the rest. Each has steps and a copy-paste agent prompt.
What do I need to run Kokon?
Windows 10 64-bit or later, an Apple M1 or newer Mac on macOS 15 or later, or x86-64 Linux; A graphics card with 12 GB VRAM or more (NVIDIA recommended), or an Apple Silicon Mac with 16 GB unified memory or more; 15 GB of free disk space (25 GB recommended) and about 12 GB of model downloads on first run; A photo to edit, or a sentence describing the image to create.
What are alternatives to Kokon?
Other hot AI repos in Content: Voice Studio, Anatomy, Comfy UI, Hyperframes, Earshot.
Is Kokon safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.