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.

Mac "Open Anyway" steps with screenshots in the README, site FAQ and setup guide

Gabriele Lozupone99c40e350ede
diff --git a/README.md b/README.md
index 11de369..9df1af6 100644
--- a/README.md
+++ b/README.md
@@ -405,9 +405,21 @@ release notes, or [build it yourself](#build-from-source).
<br>
Kokon is not notarized by Apple (that needs a paid Apple developer account), 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. You can also [build it yourself](#build-from-source).
+it the first time. You only do this once; in-app updates don't trigger it again.
+
+1. Open Kokon. macOS says **“Kokon” Not Opened**: click **Done** (not *Move to Trash*).
+
+ <img src="docs/media/mac/not-opened.png" alt="The macOS dialog “Kokon” Not Opened, with the buttons Move to Trash and Done" width="260">
+
+2. Open **System Settings → Privacy & Security** and scroll down to **Security**. Next to
+ “Kokon” was blocked to protect your Mac, click **Open Anyway**, then confirm with your
+ password or Touch ID.
+
+ <img src="docs/media/mac/open-anyway.png" alt="System Settings, Privacy and Security: “Kokon” was blocked to protect your Mac, with the Open Anyway button highlighted" width="560">
+
+3. Open Kokon again and click **Open** in the last prompt.
+
+You can also [build it yourself](#build-from-source).
</details>
diff --git a/docs/media/mac/not-opened.png b/docs/media/mac/not-opened.png
new file mode 100644
index 0000000..a24ef57
Binary files /dev/null and b/docs/media/mac/not-opened.png differ
diff --git a/docs/media/mac/open-anyway.png b/docs/media/mac/open-anyway.png
new file mode 100644
index 0000000..75700b5
Binary files /dev/null and b/docs/media/mac/open-anyway.png differ
diff --git a/site/404.html b/site/404.html
index 1c50033..04f4eae 100644
--- a/site/404.html
+++ b/site/404.html
@@ -9,7 +9,7 @@
<link rel="icon" href="/assets/favicon.ico" sizes="any">
<link rel="apple-touch-icon" href="/assets/apple-touch-icon.png">
<link href="https://fonts.googleapis.com/css2?family=Inter:opsz,[email protected],400..700&display=swap" rel="stylesheet">
-<link rel="stylesheet" href="/assets/style.css?v=3">
+<link rel="stylesheet" href="/assets/style.css?v=4">
</head>
<body>
<main class="final" style="min-height:100vh;display:grid;place-items:center;padding:40px 0">
diff --git a/site/assets/mac/not-opened.webp b/site/assets/mac/not-opened.webp
new file mode 100644
index 0000000..4ed165c
Binary files /dev/null and b/site/assets/mac/not-opened.webp differ
diff --git a/site/assets/mac/open-anyway.webp b/site/assets/mac/open-anyway.webp
new file mode 100644
index 0000000..be4cf2f
Binary files /dev/null and b/site/assets/mac/open-anyway.webp differ
diff --git a/site/assets/style.css b/site/assets/style.css
index f6e95da..5c9c374 100644
--- a/site/assets/style.css
+++ b/site/assets/style.css
@@ -182,6 +182,13 @@ summary::-webkit-details-marker { display: none; }
summary::after { content: "+"; font-weight: 400; font-size: 26px; line-height: 1; color: var(--text-3); transition: transform 0.25s; }
details[open] summary::after { transform: rotate(45deg); }
details p { margin: -6px 0 22px; color: var(--text-2); max-width: 44em; }
+details p:has(+ .mac-steps) { margin-bottom: 12px; }
+/* Mac "Open Anyway" steps with screenshots (FAQ and setup guide) */
+.mac-steps { margin: 0 0 24px; padding-left: 1.4em; color: var(--text-2); max-width: 44em; }
+.mac-steps li { margin: 0 0 16px; padding-left: 4px; }
+.mac-steps img { display: block; margin-top: 12px; max-width: 100%; height: auto; }
+.mac-steps img.dialog { width: 230px; }
+.mac-steps img.settings { width: 520px; border-radius: 12px; box-shadow: 0 0 0 1px var(--line); }
/* Maker */
.maker { display: inline-flex; align-items: center; gap: 14px; margin-top: 56px; padding: 10px 22px 10px 10px; border-radius: 999px; background: var(--card); box-shadow: inset 0 0 0 1px var(--line); text-align: left; transition: background 0.2s; }
diff --git a/site/index.html b/site/index.html
index 588a1bc..8937398 100644
--- a/site/index.html
+++ b/site/index.html
@@ -90,7 +90,7 @@
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:opsz,[email protected],400..700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-<link rel="stylesheet" href="assets/style.css?v=3">
+<link rel="stylesheet" href="assets/style.css?v=4">
<script type="application/ld+json">
{
"@context": "https://schema.org",
@@ -450,7 +450,13 @@
<details><summary>Is it an alternative to Photoshop Generative Fill?</summary><p>For many edits, yes: paint an area and describe what should be there, or remove, replace and add objects. It runs offline and costs nothing, but it is an AI editor, not a full layer-based image editor.</p></details>
<details><summary>Can I use the images commercially?</summary><p>Not with the default model. The app is open source (AGPL-3.0), but Qwen-Image 2.1 is released under the Qwen Research License: research and evaluation only, no commercial use without a license from the Qwen team. The optional upscaler is also non-commercial (CC BY-NC-SA 4.0).</p></details>
<details><summary>Windows says the app is unrecognized. Is it safe?</summary><p>The beta installer is not code-signed yet, so SmartScreen warns about it. Click &quot;More info&quot; and then &quot;Run anyway&quot;. The code is public and every download the app makes is checked against a pinned hash.</p></details>
- <details><summary>macOS says Kokon cannot be opened. What do I do?</summary><p>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 &amp; Security, scroll down and click &quot;Open Anyway&quot;. You only do this once; in-app updates don&#39;t trigger it again.</p></details>
+ <details id="mac-open"><summary>macOS says Kokon cannot be opened. What do I do?</summary><p>The beta is not notarized by Apple yet, so macOS blocks it the first time:</p>
+ <ol class="mac-steps">
+ <li>Open Kokon. macOS says <strong>&ldquo;Kokon&rdquo; Not Opened</strong>: click <strong>Done</strong> (not <em>Move to Trash</em>).<img class="dialog" src="assets/mac/not-opened.webp" width="534" height="550" alt="The macOS dialog &ldquo;Kokon&rdquo; Not Opened, with the buttons Move to Trash and Done" loading="lazy"></li>
+ <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>
+ </details>
<details><summary>Does it work offline?</summary><p>Yes. After setup has downloaded the models, everything runs offline.</p></details>
</div>
</div>
diff --git a/site/mcp-image-generation/index.html b/site/mcp-image-generation/index.html
index 0df5dd7..3ff2efa 100644
--- a/site/mcp-image-generation/index.html
+++ b/site/mcp-image-generation/index.html
@@ -22,7 +22,7 @@
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:opsz,[email protected],400..700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-<link rel="stylesheet" href="../assets/style.css?v=3">
+<link rel="stylesheet" href="../assets/style.css?v=4">
<script type="application/ld+json">
{
"@context": "https://schema.org",
diff --git a/site/qwen-image-2-1-local/index.html b/site/qwen-image-2-1-local/index.html
index b1f3e8f..2e5ec04 100644
--- a/site/qwen-image-2-1-local/index.html
+++ b/site/qwen-image-2-1-local/index.html
@@ -22,7 +22,7 @@
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:opsz,[email protected],400..700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-<link rel="stylesheet" href="../assets/style.css?v=3">
+<link rel="stylesheet" href="../assets/style.css?v=4">
<script type="application/ld+json">
{
"@context": "https://schema.org",
@@ -112,8 +112,13 @@
<p>Download the latest release from <a href="https://github.com/GabrieleLozupone/kokon/releases/latest" rel="noopener">GitHub</a>:</p>
<ul>
<li><strong>Windows:</strong> <code>Kokon_&lt;version&gt;_x64-setup.exe</code> (about 35 MB). It installs for your user only, no administrator rights. The beta is not code-signed yet, so if SmartScreen warns, click <em>More info → Run anyway</em>.</li>
- <li><strong>Mac (Apple Silicon, beta):</strong> <code>Kokon_&lt;version&gt;_aarch64.dmg</code>. Drag Kokon to Applications. The first time, open <em>System Settings → Privacy &amp; Security</em> and click <em>Open Anyway</em>.</li>
+ <li><strong>Mac (Apple Silicon, beta):</strong> <code>Kokon_&lt;version&gt;_aarch64.dmg</code>. Drag Kokon to Applications. The beta is not notarized by Apple yet, so macOS blocks it the first time:</li>
</ul>
+ <ol class="mac-steps">
+ <li>Open Kokon. macOS says <strong>&ldquo;Kokon&rdquo; Not Opened</strong>: click <strong>Done</strong> (not <em>Move to Trash</em>).<img class="dialog" src="../assets/mac/not-opened.webp" width="534" height="550" alt="The macOS dialog &ldquo;Kokon&rdquo; Not Opened, with the buttons Move to Trash and Done" loading="lazy"></li>
+ <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>
<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>