Skip to content

armgit / kokon

Public Imported from GitHub
0

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.

docs(mac): Terminal fallback when macOS only says Kokon can't be opened

Gabriele Lozupone3ba4de2c2a1a
diff --git a/README.md b/README.md
index 663feb3..68bb63f 100644
--- a/README.md
+++ b/README.md
@@ -130,8 +130,8 @@ seeds and times are in [marketing/showcase/PROMPTS.md](marketing/showcase/PROMPT
administrator rights.
- **Mac (Apple Silicon, beta):** `Kokon_<version>_aarch64.dmg`. Open it and drag Kokon to
Applications. The first time, macOS blocks it because the app is not notarized by Apple:
- open System Settings → Privacy & Security and click **Open Anyway**
- ([details](#macos-says-kokon-cannot-be-opened)).
+ open System Settings → Privacy & Security and click **Open Anyway**, or run one Terminal
+ command if there is no such button ([details](#macos-says-kokon-cannot-be-opened)).
**2. Set up models.** On first launch Kokon shows your graphics card (or your Mac's chip and
memory), recommends a preset and downloads everything it needs. The download resumes if it is
@@ -439,6 +439,16 @@ it the first time. You only do this once; in-app updates don't trigger it again.
3. Open Kokon again and click **Open** in the last prompt.
+If macOS instead only says **The application “Kokon” can't be opened**, with just an **OK**
+button, and Privacy & Security shows no *Open Anyway*: open **Terminal** and run
+
+```bash
+xattr -dr com.apple.quarantine /Applications/Kokon.app
+```
+
+then open Kokon as usual. This removes the "downloaded from the internet" flag from Kokon only;
+Gatekeeper stays on for everything else.
+
You can also [build it yourself](#build-from-source).
</details>
diff --git a/site/index.html b/site/index.html
index e00a73f..9097d83 100644
--- a/site/index.html
+++ b/site/index.html
@@ -175,7 +175,7 @@
"name": "macOS says Kokon cannot be opened. What do I do?",
"acceptedAnswer": {
"@type": "Answer",
- "text": "The beta is not notarized by Apple yet, so macOS blocks it the first time. Try to open it once, then go to System Settings, Privacy & Security, scroll down and click \"Open Anyway\". You only do this once; in-app updates don't trigger it again."
+ "text": "The beta is not notarized by Apple yet, so macOS blocks it the first time. Try to open it once, then go to System Settings, Privacy & Security, scroll down and click \"Open Anyway\". You only do this once; in-app updates don't trigger it again. If macOS only says the app can't be opened, with just an OK button and no Open Anyway in Settings, run xattr -dr com.apple.quarantine /Applications/Kokon.app in Terminal, then open Kokon."
}
},
{
@@ -467,6 +467,7 @@
<li>Open <strong>System Settings &rarr; Privacy &amp; Security</strong> and scroll down to <strong>Security</strong>. Next to &ldquo;Kokon&rdquo; was blocked to protect your Mac, click <strong>Open Anyway</strong> and confirm with your password or Touch ID.<img class="settings" src="assets/mac/open-anyway.webp" width="970" height="360" alt="System Settings, Privacy and Security: &ldquo;Kokon&rdquo; was blocked to protect your Mac, with the Open Anyway button highlighted" loading="lazy"></li>
<li>Open Kokon again and click <strong>Open</strong>. You only do this once; in-app updates don&#39;t trigger it again.</li>
</ol>
+ <p>If macOS instead only says <strong>The application &ldquo;Kokon&rdquo; can&#39;t be opened</strong>, with just an <strong>OK</strong> button, and Privacy &amp; Security shows no <em>Open Anyway</em>: open <strong>Terminal</strong>, run <code>xattr -dr com.apple.quarantine /Applications/Kokon.app</code>, then open Kokon as usual. This removes the &ldquo;downloaded from the internet&rdquo; flag from Kokon only.</p>
</details>
<details><summary>How do I write good prompts for Qwen-Image 2.1?</summary><p>Describe the scene, not just the subject: who, doing what, where, in what light. Never write &ldquo;no X&rdquo; (it adds X), put text in quotes, and for edits name the exact thing to change. The <a href="prompt-guide/" style="text-decoration:underline">prompt guide</a> shows each rule with a vague and a clear prompt side by side.</p></details>
<details><summary>Does it work offline?</summary><p>Yes. After setup has downloaded the models, everything runs offline.</p></details>
diff --git a/site/qwen-image-2-1-local/index.html b/site/qwen-image-2-1-local/index.html
index 9ac5a83..154b8b2 100644
--- a/site/qwen-image-2-1-local/index.html
+++ b/site/qwen-image-2-1-local/index.html
@@ -120,6 +120,7 @@
<li>Open <strong>System Settings &rarr; Privacy &amp; Security</strong> and scroll down to <strong>Security</strong>. Next to &ldquo;Kokon&rdquo; was blocked to protect your Mac, click <strong>Open Anyway</strong> and confirm with your password or Touch ID.<img class="settings" src="../assets/mac/open-anyway.webp" width="970" height="360" alt="System Settings, Privacy and Security: &ldquo;Kokon&rdquo; was blocked to protect your Mac, with the Open Anyway button highlighted" loading="lazy"></li>
<li>Open Kokon again and click <strong>Open</strong>. You only do this once; in-app updates don&#39;t trigger it again.</li>
</ol>
+ <p>If macOS instead only says <strong>The application &ldquo;Kokon&rdquo; can&#39;t be opened</strong>, with just an <strong>OK</strong> button, and Privacy &amp; Security shows no <em>Open Anyway</em>: open <strong>Terminal</strong>, run <code>xattr -dr com.apple.quarantine /Applications/Kokon.app</code>, then open Kokon as usual. This removes the &ldquo;downloaded from the internet&rdquo; flag from Kokon only.</p>
<h2>Step 2: Let it download the model</h2>
<p>On first launch Kokon shows your graphics card (or your Mac's chip and memory) and recommends a preset. It downloads what it needs: the stable-diffusion.cpp engine, <strong>Qwen-Image 2.1 Turbo</strong> as a 4-bit GGUF (about 4 GB), the Qwen3-VL text encoder and the VAE, about 12 GB in total. Downloads resume if interrupted, and every file is checked against a pinned SHA-256 hash.</p>