PyPI - zerochat - Versions diffs - 7.3.0__py3-none-any.whl - Mend

zerochat 7.3.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (130) hide show

zerochat-7.3.0.dist-info/METADATA +70 -0
zerochat-7.3.0.dist-info/RECORD +130 -0
zerochat-7.3.0.dist-info/WHEEL +5 -0
zerochat-7.3.0.dist-info/entry_points.txt +2 -0
zerochat-7.3.0.dist-info/licenses/LICENSE +34 -0
zerochat-7.3.0.dist-info/top_level.txt +2 -0
zerochat.py +2004 -0
zerochat_runtime/__init__.py +1 -0
zerochat_runtime/assets/css/base.css +199 -0
zerochat_runtime/assets/css/components/composer.css +1258 -0
zerochat_runtime/assets/css/components/debug.css +777 -0
zerochat_runtime/assets/css/components/header.css +97 -0
zerochat_runtime/assets/css/components/icons.css +39 -0
zerochat_runtime/assets/css/components/markdown.css +685 -0
zerochat_runtime/assets/css/components/messages.css +473 -0
zerochat_runtime/assets/css/components/modals.css +1319 -0
zerochat_runtime/assets/css/components/sidebar.css +622 -0
zerochat_runtime/assets/css/components/tools.css +1223 -0
zerochat_runtime/assets/css/layout.css +171 -0
zerochat_runtime/assets/css/print.css +120 -0
zerochat_runtime/assets/css/styles.css +18 -0
zerochat_runtime/assets/css/theme-overrides.css +555 -0
zerochat_runtime/assets/css/tokens.css +165 -0
zerochat_runtime/assets/help/architecture.html +247 -0
zerochat_runtime/assets/help/composer.html +134 -0
zerochat_runtime/assets/help/conversations.html +105 -0
zerochat_runtime/assets/help/debug.html +108 -0
zerochat_runtime/assets/help/en/architecture.html +247 -0
zerochat_runtime/assets/help/en/composer.html +134 -0
zerochat_runtime/assets/help/en/conversations.html +104 -0
zerochat_runtime/assets/help/en/debug.html +105 -0
zerochat_runtime/assets/help/en/gemini-free.html +39 -0
zerochat_runtime/assets/help/en/index.html +191 -0
zerochat_runtime/assets/help/en/learning.html +71 -0
zerochat_runtime/assets/help/en/mcp.html +143 -0
zerochat_runtime/assets/help/en/openrouter-free.html +39 -0
zerochat_runtime/assets/help/en/profiles.html +173 -0
zerochat_runtime/assets/help/en/rag.html +130 -0
zerochat_runtime/assets/help/en/reasoning-telemetry.html +108 -0
zerochat_runtime/assets/help/en/tools-agent.html +133 -0
zerochat_runtime/assets/help/en/webllm.html +355 -0
zerochat_runtime/assets/help/gemini-free.html +39 -0
zerochat_runtime/assets/help/help.css +604 -0
zerochat_runtime/assets/help/help.js +51 -0
zerochat_runtime/assets/help/index.html +194 -0
zerochat_runtime/assets/help/learning.html +71 -0
zerochat_runtime/assets/help/mcp.html +143 -0
zerochat_runtime/assets/help/openrouter-free.html +39 -0
zerochat_runtime/assets/help/profiles.html +174 -0
zerochat_runtime/assets/help/rag.html +130 -0
zerochat_runtime/assets/help/reasoning-telemetry.html +111 -0
zerochat_runtime/assets/help/tools-agent.html +133 -0
zerochat_runtime/assets/help/webllm.html +359 -0
zerochat_runtime/assets/js/agent-core.js +1553 -0
zerochat_runtime/assets/js/api.js +844 -0
zerochat_runtime/assets/js/app.js +2558 -0
zerochat_runtime/assets/js/attachments.js +220 -0
zerochat_runtime/assets/js/charts.js +338 -0
zerochat_runtime/assets/js/chat-engine.js +566 -0
zerochat_runtime/assets/js/config-store.js +207 -0
zerochat_runtime/assets/js/context-manager.js +584 -0
zerochat_runtime/assets/js/conversation-service.js +484 -0
zerochat_runtime/assets/js/cookies.js +688 -0
zerochat_runtime/assets/js/data-reset-service.js +136 -0
zerochat_runtime/assets/js/debug.js +508 -0
zerochat_runtime/assets/js/defaults.js +16 -0
zerochat_runtime/assets/js/export.js +179 -0
zerochat_runtime/assets/js/file-parser.js +2088 -0
zerochat_runtime/assets/js/generation-controller.js +417 -0
zerochat_runtime/assets/js/i18n.js +1483 -0
zerochat_runtime/assets/js/icons.js +156 -0
zerochat_runtime/assets/js/ingestionEngine.js +436 -0
zerochat_runtime/assets/js/markdown.js +588 -0
zerochat_runtime/assets/js/mcp.js +1271 -0
zerochat_runtime/assets/js/message-turns.js +62 -0
zerochat_runtime/assets/js/profile-backup.js +118 -0
zerochat_runtime/assets/js/profile-export-bundle.js +481 -0
zerochat_runtime/assets/js/profile-repository.js +213 -0
zerochat_runtime/assets/js/providers-webllm.js +486 -0
zerochat_runtime/assets/js/providers.js +1560 -0
zerochat_runtime/assets/js/rag-index.js +295 -0
zerochat_runtime/assets/js/rag-service.js +530 -0
zerochat_runtime/assets/js/rag-ui.js +997 -0
zerochat_runtime/assets/js/ragStorage.js +676 -0
zerochat_runtime/assets/js/sandbox.js +449 -0
zerochat_runtime/assets/js/state.js +704 -0
zerochat_runtime/assets/js/storage-db.js +144 -0
zerochat_runtime/assets/js/tool-cards.js +330 -0
zerochat_runtime/assets/js/tool-security.js +653 -0
zerochat_runtime/assets/js/tools/README.md +50 -0
zerochat_runtime/assets/js/tools/builtin/agent-checkpoint.tool.js +212 -0
zerochat_runtime/assets/js/tools/builtin/download-pdf.tool.js +111 -0
zerochat_runtime/assets/js/tools/builtin/execute-javascript.tool.js +219 -0
zerochat_runtime/assets/js/tools/builtin/fetch-web-page.tool.js +112 -0
zerochat_runtime/assets/js/tools/builtin/list-documents.tool.js +117 -0
zerochat_runtime/assets/js/tools/builtin/read-knowledge-chunk.tool.js +129 -0
zerochat_runtime/assets/js/tools/builtin/read-knowledge-image.tool.js +95 -0
zerochat_runtime/assets/js/tools/builtin/render-chart.tool.js +90 -0
zerochat_runtime/assets/js/tools/builtin/search-knowledge-base.tool.js +124 -0
zerochat_runtime/assets/js/tools/builtin/search-web.tool.js +125 -0
zerochat_runtime/assets/js/tools/tool-manifest.js +53 -0
zerochat_runtime/assets/js/tools/tool-runtime.js +77 -0
zerochat_runtime/assets/js/ui-composer.js +319 -0
zerochat_runtime/assets/js/ui-conversation.js +655 -0
zerochat_runtime/assets/js/ui-dialogs.js +132 -0
zerochat_runtime/assets/js/ui-generation-status.js +119 -0
zerochat_runtime/assets/js/ui-inspector.js +804 -0
zerochat_runtime/assets/js/ui-mcp.js +604 -0
zerochat_runtime/assets/js/ui-profiles.js +824 -0
zerochat_runtime/assets/js/ui-reasoning.js +146 -0
zerochat_runtime/assets/js/ui-settings.js +825 -0
zerochat_runtime/assets/js/ui-shell.js +215 -0
zerochat_runtime/assets/js/ui-sidebar.js +429 -0
zerochat_runtime/assets/js/ui-telemetry.js +404 -0
zerochat_runtime/assets/js/ui-transfer.js +262 -0
zerochat_runtime/assets/js/utils.js +216 -0
zerochat_runtime/assets/js/vendor/orama.browser.js +11 -0
zerochat_runtime/assets/js/web-browser.js +569 -0
zerochat_runtime/assets/js/web-search.js +519 -0
zerochat_runtime/assets/manifest.webmanifest +20 -0
zerochat_runtime/assets/services/dummy_mcp/dummy_mcp_server.py +47 -0
zerochat_runtime/assets/services/dummy_mcp/service.json +22 -0
zerochat_runtime/assets/services/lsp/installer.json +9 -0
zerochat_runtime/assets/services/lsp/service.json +22 -0
zerochat_runtime/assets/services/memory/installer.json +9 -0
zerochat_runtime/assets/services/memory/service.json +24 -0
zerochat_runtime/assets/services/playwright/installer.json +10 -0
zerochat_runtime/assets/services/playwright/service.json +39 -0
zerochat_runtime/assets/sw.js +164 -0
zerochat_runtime/assets/zerochat.html +671 -0

zerochat_runtime/assets/help/en/webllm.html ADDED Viewed

@@ -0,0 +1,355 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>WebLLM & WebGPU Setup Guide · ZeroChat Help</title>
+  <meta name="description" content="Technical guide for running local AI models directly in the browser using WebLLM and WebGPU in ZeroChat.">
+  <link rel="stylesheet" href="../help.css">
+  <style>
+    .browser-grid {
+      display: grid;
+      grid-template-columns: 1fr;
+      gap: 1.5rem;
+    }
+    @media (min-width: 768px) {
+      .browser-grid {
+        grid-template-columns: 1fr 1fr;
+      }
+    }
+    .spec-table {
+      width: 100%;
+      border-collapse: collapse;
+      margin: 1rem 0;
+      font-size: 0.9rem;
+    }
+    .spec-table th, .spec-table td {
+      border: 1px solid var(--border-color);
+      padding: 0.6rem 0.85rem;
+      text-align: left;
+    }
+    .spec-table th {
+      background: var(--bg-card-subtle);
+      font-weight: 600;
+    }
+    .icon-inline {
+      display: inline-block;
+      vertical-align: -0.15em;
+      width: 1.1em;
+      height: 1.1em;
+      stroke-width: 2;
+      stroke: currentColor;
+      fill: none;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="../webllm.html" class="top-nav-link">Español 🌐</a>
+          <a href="index.html" class="top-nav-link">← Back to Index</a>
+        </div>
+      </div>
+      <h1>WebLLM & WebGPU Configuration</h1>
+      <p class="subtitle">Step-by-step setup guide for running AI models directly on your hardware GPU inside the browser.</p>
+    </header>
+    <div class="card">
+      <h2>What is WebLLM and what are its advantages?</h2>
+      <p>
+        <strong>WebLLM</strong> is a cutting-edge engine that executes Large Language Models entirely inside the web browser utilizing your graphics card (GPU) through the standardized <strong>WebGPU</strong> API.
+      </p>
+      <ul>
+        <li><strong>Complete privacy:</strong> Prompts and responses never leave your device; there is zero telemetry or intermediary servers.</li>
+        <li><strong>Zero cost or subscription:</strong> Requires no paid API keys or cloud server infrastructure.</li>
+        <li><strong>Offline functionality:</strong> Once a model is downloaded into your browser's persistent Cache Storage, it runs even without internet access.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>Hardware Requirements & VRAM Guidelines</h2>
+      <p>WebGPU performance depends on available GPU video memory (VRAM):</p>
+      <table class="spec-table">
+        <thead>
+          <tr>
+            <th>Model Parameter Size</th>
+            <th>Recommended VRAM</th>
+            <th>Sample Models in Catalog</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><strong>0.5B – 1.5B (Lightweight)</strong></td>
+            <td>1.5 GB – 2.5 GB</td>
+            <td>Qwen2.5-0.5B, SmolLM2-1.7B, Qwen2.5-1.5B</td>
+          </tr>
+          <tr>
+            <td><strong>3B – 4B (Balanced)</strong></td>
+            <td>3 GB – 4.5 GB</td>
+            <td>Llama-3.2-3B, Phi-3.5-mini</td>
+          </tr>
+          <tr>
+            <td><strong>7B – 8B (High Quality)</strong></td>
+            <td>6 GB – 8 GB</td>
+            <td>Llama-3.1-8B-Instruct, Mistral-7B-Instruct</td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <h2>Browser Configuration &amp; WebGPU Setup</h2>
+    <div class="browser-grid">
+      <!-- Google Chrome / Edge / Brave -->
+      <div class="card">
+        <h3>Google Chrome, Edge and Chromium</h3>
+        <p>Chromium-based browsers provide top-tier performance and reliability with WebGPU.</p>
+        <ol>
+          <li>
+            <strong>Enable hardware acceleration:</strong>
+            <p>Go to Settings &gt; System and ensure <em>"Use hardware acceleration when available"</em> is enabled.</p>
+            <div class="code-box">
+              <code>chrome://settings/system</code>
+              <button class="btn-copy" onclick="copyText('chrome://settings/system', this)">Copy</button>
+            </div>
+          </li>
+          <li>
+            <strong>Enable unsafe WebGPU (Recommended for maximum compatibility):</strong>
+            <p>Paste into your address bar, set the flag to <strong>Enabled</strong>, and relaunch your browser:</p>
+            <div class="code-box">
+              <code>chrome://flags/#enable-unsafe-webgpu</code>
+              <button class="btn-copy" onclick="copyText('chrome://flags/#enable-unsafe-webgpu', this)">Copy</button>
+            </div>
+          </li>
+          <li>
+            <strong>WebGPU Interoperability on Linux (Recommended for Linux and Wayland):</strong>
+            <p>On Linux (especially when running Wayland or dedicated NVIDIA/AMD GPUs), enable this setting to connect WebGPU compute directly to the browser window without overloading the CPU:</p>
+            <div class="code-box">
+              <code>chrome://flags/#force-enable-webgpu-interop</code>
+              <button class="btn-copy" onclick="copyText('chrome://flags/#force-enable-webgpu-interop', this)">Copy</button>
+            </div>
+          </li>
+          <li>
+            <strong>Check GPU diagnostics:</strong>
+            <p>Open the internal graphics status page and verify that <em>WebGPU</em> is listed as <em>"Hardware accelerated"</em>:</p>
+            <div class="code-box">
+              <code>chrome://gpu</code>
+              <button class="btn-copy" onclick="copyText('chrome://gpu', this)">Copy</button>
+            </div>
+          </li>
+        </ol>
+      </div>
+      <!-- Mozilla Firefox -->
+      <div class="card">
+        <h3>Mozilla Firefox</h3>
+        <p>WebGPU is in active rollout in Firefox and requires enabling specific preferences:</p>
+        <ol>
+          <li>
+            <strong>Open the advanced preferences editor:</strong>
+            <p>Type into the address bar and click <em>"Accept the Risk and Continue"</em>:</p>
+            <div class="code-box">
+              <code>about:config</code>
+              <button class="btn-copy" onclick="copyText('about:config', this)">Copy</button>
+            </div>
+          </li>
+          <li>
+            <strong>Enable the WebGPU API:</strong>
+            <p>Search for this preference and toggle its value to <strong>true</strong>:</p>
+            <div class="code-box">
+              <code>dom.webgpu.enabled</code>
+              <button class="btn-copy" onclick="copyText('dom.webgpu.enabled', this)">Copy</button>
+            </div>
+          </li>
+          <li>
+            <strong>Ignore driver blocklist (Recommended on Linux/Windows):</strong>
+            <p>Allows Firefox to use WebGPU even if your driver is not yet on the official whitelist:</p>
+            <div class="code-box">
+              <code>gfx.webgpu.ignore-status</code>
+              <button class="btn-copy" onclick="copyText('gfx.webgpu.ignore-status', this)">Copy</button>
+            </div>
+          </li>
+          <li>
+            <strong>Check Firefox GPU status:</strong>
+            <p>Review the <em>Graphics &gt; WebGPU</em> section to confirm hardware adapter detection:</p>
+            <div class="code-box">
+              <code>about:support</code>
+              <button class="btn-copy" onclick="copyText('about:support', this)">Copy</button>
+            </div>
+          </li>
+        </ol>
+      </div>
+    </div>
+    <div class="card">
+      <h2>How to Use WebLLM in ZeroChat</h2>
+      <ol>
+        <li>In ZeroChat, open the <strong>Profile Management</strong> dialog.</li>
+        <li>Select the <strong>WebLLM (local WebGPU)</strong> interface type.</li>
+        <li>
+          <strong>If you already have downloaded models:</strong>
+          They appear automatically at the top of the model dropdown. Pick any downloaded model and save the profile immediately without needing to click <em>Query</em>.
+        </li>
+        <li>
+          <strong>To download a new model:</strong>
+          Click the <strong>Query</strong> button. Browse the available catalog with required VRAM metrics, click the download icon next to your desired model, and wait for shader compilation to finish.
+        </li>
+        <li>
+          Once download completes, the model will be tagged as <em>"Cached"</em> and stored permanently in your browser.
+        </li>
+      </ol>
+    </div>
+    <div class="card">
+      <h2>Advanced WebGPU Execution Parameters</h2>
+      <p>
+        When configuring a profile with the <strong>WebLLM</strong> provider, next to the model selector you will find a gear icon button that reveals the advanced performance panel. These dropdown selectors allow you to fine-tune VRAM usage and inference speed according to your GPU capabilities:
+      </p>
+      <ul>
+        <li>
+          <strong>Context window (<code>context_window_size</code>):</strong> Dropdown selector for the maximum token capacity in the KV Cache (e.g., 2048, 4096, 8192, 16384, 32768). By default, browser builds often limit this to 2048 or 4096 to prevent out-of-memory errors on integrated or mobile GPUs. If your GPU has ample VRAM, increasing this retains longer conversations and large documents without truncation.
+        </li>
+        <li>
+          <strong>Prefill chunk size (<code>prefill_chunk_size</code>):</strong> Dropdown selector for the number of tokens processed concurrently by the GPU during prompt evaluation (512, 1024, 2048, 4096). Higher values take full advantage of dedicated GPUs, reducing time to first token (TTFT).
+        </li>
+      </ul>
+      <p>
+        The first choice in each dropdown is <em>"Model default"</em> (<code>default</code>), instructing ZeroChat to preserve the model's standard default configuration. These settings are stored as part of the connection profile.
+      </p>
+    </div>
+    <div class="card">
+      <h2>How to Revert Changes and Restore Default Configuration</h2>
+      <p>
+        If you wish to undo the technical changes made to your browser or ZeroChat and return to factory defaults, follow the instructions below:
+      </p>
+      <h3>1. Google Chrome, Microsoft Edge, and Chromium</h3>
+      <ul>
+        <li>
+          <strong>Restore the specific WebGPU flag:</strong>
+          <p>Navigate back to the flag URL and select <strong>Default</strong> from the dropdown menu:</p>
+          <div class="code-box">
+            <code>chrome://flags/#enable-unsafe-webgpu</code>
+            <button class="btn-copy" onclick="copyText('chrome://flags/#enable-unsafe-webgpu', this)">Copy</button>
+          </div>
+          <p>Click the <strong>Relaunch</strong> button that appears at the bottom of the screen to restart the browser with default settings.</p>
+        </li>
+        <li>
+          <strong>Reset all experimental flags:</strong>
+          <p>If you adjusted multiple parameters and want to return everything to out-of-the-box defaults, open the main flags page and click the <strong>"Reset all"</strong> button in the upper-right corner:</p>
+          <div class="code-box">
+            <code>chrome://flags</code>
+            <button class="btn-copy" onclick="copyText('chrome://flags', this)">Copy</button>
+          </div>
+        </li>
+        <li>
+          <strong>Hardware Acceleration:</strong>
+          <p>In <code>chrome://settings/system</code>, you can toggle <em>"Use hardware acceleration when available"</em> according to your standard preference.</p>
+        </li>
+      </ul>
+      <h3>2. Mozilla Firefox</h3>
+      <ul>
+        <li>
+          <strong>Open advanced configuration:</strong>
+          <p>Type into your address bar and accept the warning:</p>
+          <div class="code-box">
+            <code>about:config</code>
+            <button class="btn-copy" onclick="copyText('about:config', this)">Copy</button>
+          </div>
+        </li>
+        <li>
+          <strong>Reset modified preferences:</strong>
+          <p>Search for each modified preference (they will be displayed in <strong>bold</strong>, indicating a custom non-default value):</p>
+          <ul>
+            <li><code>dom.webgpu.enabled</code> (factory default: <strong>false</strong>)</li>
+            <li><code>gfx.webgpu.ignore-status</code> (factory default: <strong>false</strong> or non-existent)</li>
+          </ul>
+          <p>Click the <strong>Reset</strong> button (the curved back-arrow icon at the right edge of the row) or double-click the row so it returns to <code>false</code> and is no longer bold.</p>
+        </li>
+        <li>
+          <strong>Restart the browser:</strong>
+          <p>Close and restart Firefox so that graphics and GPU subsystems reinitialize under default parameters.</p>
+        </li>
+      </ul>
+      <h3>3. Freeing Disk Space (Deleting Downloaded Models from Cache)</h3>
+      <p>
+        Local WebLLM models are stored in the browser's persistent storage (<em>Cache Storage</em> / <em>IndexedDB</em>) and can take up several gigabytes. If you want to delete them to reclaim disk space:
+      </p>
+      <ul>
+        <li>
+          <strong>In Google Chrome, Edge, and Chromium:</strong>
+          <ol>
+            <li>Click the tune/padlock site settings icon to the left of the address bar while visiting ZeroChat.</li>
+            <li>Select <em>"Site settings"</em> and click <strong>"Clear data"</strong>.</li>
+            <li>Alternatively, press <kbd>F12</kbd> &gt; <strong>Application</strong> tab &gt; <strong>Storage</strong> section &gt; click <strong>"Clear site data"</strong>.</li>
+          </ol>
+        </li>
+        <li>
+          <strong>In Mozilla Firefox:</strong>
+          <ol>
+            <li>Open Settings &gt; <em>Privacy &amp; Security</em> section &gt; <em>Cookies and Site Data</em>.</li>
+            <li>Click <strong>"Manage Data..."</strong>, search for the ZeroChat domain, and click <strong>"Remove Selected"</strong>.</li>
+            <li>Alternatively, press <kbd>F12</kbd> &gt; <strong>Storage</strong> tab &gt; <strong>Cache Storage</strong>, right-click any <code>webllm/model</code> entries, and click <strong>Delete</strong>.</li>
+          </ol>
+        </li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>Troubleshooting Common Issues &amp; Compatibility</h2>
+      <p>ZeroChat executes WebLLM through an in-memory self-contained classic Web Worker, ensuring full compatibility in both Google Chrome and Mozilla Firefox in a purely static web setup (without requiring local build steps or special browser flags). The JavaScript runtime is persistently cached in <em>Cache Storage</em> and automatically refreshed every 7 days when an active internet connection is available (with seamless offline fallback when disconnected).</p>
+      <p>Settings → Clear all data deletes storage for the current origin, including RAG, attachments, downloaded models, IndexedDB, Cache Storage and browser-private files. Close other tabs before confirming. Deletion is irreversible and affects applications sharing the origin. Repeat it for each HTTP or HTTPS origin you used. It does not delete files downloaded to your computer, HttpOnly cookies or the browser's internal HTTP cache.</p>
+      <p>If preparation fails, the model row displays the error detail received from WebLLM. Copy the complete message to diagnose hardware resource access and GPU WebGPU acceleration.</p>
+      <ul>
+        <li>
+          <strong>"WebGPU is not available in this browser":</strong> Ensure you are running the latest browser version with WebGPU flags enabled as described above.
+        </li>
+        <li>
+          <strong>Out of Memory (OOM) Errors:</strong> If the tab crashes or reloads during shader compilation, select a lighter model (0.5B – 1.5B) or close other GPU-intensive tabs.
+        </li>
+        <li>
+          <strong>Private Browsing / Incognito Mode:</strong> Incognito mode may wipe browser cache on exit. Use a regular browsing window to keep downloaded models permanently cached.
+        </li>
+      </ul>
+    </div>
+    <nav class="page-navigation" aria-label="Help navigation">
+      <a href="profiles.html" class="nav-button prev">
+        <span class="nav-direction">← Previous</span>
+        <span class="nav-title">Profiles & Providers</span>
+      </a>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Index</span>
+        <span class="nav-title">View all topics</span>
+      </a>
+      <a href="tools-agent.html" class="nav-button next">
+        <span class="nav-direction">Next →</span>
+        <span class="nav-title">Agent Mode & Tools</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Universal Web AI Client · User Manual</p>
+    </footer>
+  </div>
+  <script src="../help.js"></script>
+</body>
+</html>

zerochat_runtime/assets/help/gemini-free.html ADDED Viewed

@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>API key de Gemini · ZeroChat</title>
+  <meta name="description" content="Cómo crear una API key de Gemini para usarla en ZeroChat.">
+  <link rel="stylesheet" href="help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>Obtener una API key de Gemini</h1>
+      <p class="subtitle">La clave se crea desde Google AI Studio con tu cuenta de Google.</p>
+    </header>
+    <main>
+      <section class="card">
+        <h2>Pasos</h2>
+        <ol>
+          <li>
+            Abre <a href="https://aistudio.google.com/apikey" target="_blank" rel="noopener noreferrer">la página oficial de API keys de Google AI Studio</a> e inicia sesión con tu cuenta de Google.
+          </li>
+          <li>Acepta las condiciones si Google te las solicita. Las cuentas nuevas pueden recibir un proyecto y una clave inicial automáticamente.</li>
+          <li>Si no tienes una clave para usar, pulsa <strong>Create API key</strong> y sigue el diálogo para crear o elegir un proyecto.</li>
+          <li>Copia la API key y guárdala en un lugar privado.</li>
+          <li>En ZeroChat, crea o edita un perfil de proveedor <strong>Gemini</strong>, pega la clave y selecciona un modelo disponible.</li>
+        </ol>
+      </section>
+      <section class="card">
+        <h2>Importante</h2>
+        <p>Los modelos, límites, precios y disponibilidad cambian. Consulta <a href="https://ai.google.dev/gemini-api/docs/billing" target="_blank" rel="noopener noreferrer">la información oficial de Gemini API</a> antes de usarla en producción.</p>
+        <p>No compartas la API key ni la publiques en chats, capturas de pantalla, repositorios o archivos de configuración públicos.</p>
+      </section>
+    </main>
+  </div>
+</body>
+</html>