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
  1. zerochat-7.3.0.dist-info/METADATA +70 -0
  2. zerochat-7.3.0.dist-info/RECORD +130 -0
  3. zerochat-7.3.0.dist-info/WHEEL +5 -0
  4. zerochat-7.3.0.dist-info/entry_points.txt +2 -0
  5. zerochat-7.3.0.dist-info/licenses/LICENSE +34 -0
  6. zerochat-7.3.0.dist-info/top_level.txt +2 -0
  7. zerochat.py +2004 -0
  8. zerochat_runtime/__init__.py +1 -0
  9. zerochat_runtime/assets/css/base.css +199 -0
  10. zerochat_runtime/assets/css/components/composer.css +1258 -0
  11. zerochat_runtime/assets/css/components/debug.css +777 -0
  12. zerochat_runtime/assets/css/components/header.css +97 -0
  13. zerochat_runtime/assets/css/components/icons.css +39 -0
  14. zerochat_runtime/assets/css/components/markdown.css +685 -0
  15. zerochat_runtime/assets/css/components/messages.css +473 -0
  16. zerochat_runtime/assets/css/components/modals.css +1319 -0
  17. zerochat_runtime/assets/css/components/sidebar.css +622 -0
  18. zerochat_runtime/assets/css/components/tools.css +1223 -0
  19. zerochat_runtime/assets/css/layout.css +171 -0
  20. zerochat_runtime/assets/css/print.css +120 -0
  21. zerochat_runtime/assets/css/styles.css +18 -0
  22. zerochat_runtime/assets/css/theme-overrides.css +555 -0
  23. zerochat_runtime/assets/css/tokens.css +165 -0
  24. zerochat_runtime/assets/help/architecture.html +247 -0
  25. zerochat_runtime/assets/help/composer.html +134 -0
  26. zerochat_runtime/assets/help/conversations.html +105 -0
  27. zerochat_runtime/assets/help/debug.html +108 -0
  28. zerochat_runtime/assets/help/en/architecture.html +247 -0
  29. zerochat_runtime/assets/help/en/composer.html +134 -0
  30. zerochat_runtime/assets/help/en/conversations.html +104 -0
  31. zerochat_runtime/assets/help/en/debug.html +105 -0
  32. zerochat_runtime/assets/help/en/gemini-free.html +39 -0
  33. zerochat_runtime/assets/help/en/index.html +191 -0
  34. zerochat_runtime/assets/help/en/learning.html +71 -0
  35. zerochat_runtime/assets/help/en/mcp.html +143 -0
  36. zerochat_runtime/assets/help/en/openrouter-free.html +39 -0
  37. zerochat_runtime/assets/help/en/profiles.html +173 -0
  38. zerochat_runtime/assets/help/en/rag.html +130 -0
  39. zerochat_runtime/assets/help/en/reasoning-telemetry.html +108 -0
  40. zerochat_runtime/assets/help/en/tools-agent.html +133 -0
  41. zerochat_runtime/assets/help/en/webllm.html +355 -0
  42. zerochat_runtime/assets/help/gemini-free.html +39 -0
  43. zerochat_runtime/assets/help/help.css +604 -0
  44. zerochat_runtime/assets/help/help.js +51 -0
  45. zerochat_runtime/assets/help/index.html +194 -0
  46. zerochat_runtime/assets/help/learning.html +71 -0
  47. zerochat_runtime/assets/help/mcp.html +143 -0
  48. zerochat_runtime/assets/help/openrouter-free.html +39 -0
  49. zerochat_runtime/assets/help/profiles.html +174 -0
  50. zerochat_runtime/assets/help/rag.html +130 -0
  51. zerochat_runtime/assets/help/reasoning-telemetry.html +111 -0
  52. zerochat_runtime/assets/help/tools-agent.html +133 -0
  53. zerochat_runtime/assets/help/webllm.html +359 -0
  54. zerochat_runtime/assets/js/agent-core.js +1553 -0
  55. zerochat_runtime/assets/js/api.js +844 -0
  56. zerochat_runtime/assets/js/app.js +2558 -0
  57. zerochat_runtime/assets/js/attachments.js +220 -0
  58. zerochat_runtime/assets/js/charts.js +338 -0
  59. zerochat_runtime/assets/js/chat-engine.js +566 -0
  60. zerochat_runtime/assets/js/config-store.js +207 -0
  61. zerochat_runtime/assets/js/context-manager.js +584 -0
  62. zerochat_runtime/assets/js/conversation-service.js +484 -0
  63. zerochat_runtime/assets/js/cookies.js +688 -0
  64. zerochat_runtime/assets/js/data-reset-service.js +136 -0
  65. zerochat_runtime/assets/js/debug.js +508 -0
  66. zerochat_runtime/assets/js/defaults.js +16 -0
  67. zerochat_runtime/assets/js/export.js +179 -0
  68. zerochat_runtime/assets/js/file-parser.js +2088 -0
  69. zerochat_runtime/assets/js/generation-controller.js +417 -0
  70. zerochat_runtime/assets/js/i18n.js +1483 -0
  71. zerochat_runtime/assets/js/icons.js +156 -0
  72. zerochat_runtime/assets/js/ingestionEngine.js +436 -0
  73. zerochat_runtime/assets/js/markdown.js +588 -0
  74. zerochat_runtime/assets/js/mcp.js +1271 -0
  75. zerochat_runtime/assets/js/message-turns.js +62 -0
  76. zerochat_runtime/assets/js/profile-backup.js +118 -0
  77. zerochat_runtime/assets/js/profile-export-bundle.js +481 -0
  78. zerochat_runtime/assets/js/profile-repository.js +213 -0
  79. zerochat_runtime/assets/js/providers-webllm.js +486 -0
  80. zerochat_runtime/assets/js/providers.js +1560 -0
  81. zerochat_runtime/assets/js/rag-index.js +295 -0
  82. zerochat_runtime/assets/js/rag-service.js +530 -0
  83. zerochat_runtime/assets/js/rag-ui.js +997 -0
  84. zerochat_runtime/assets/js/ragStorage.js +676 -0
  85. zerochat_runtime/assets/js/sandbox.js +449 -0
  86. zerochat_runtime/assets/js/state.js +704 -0
  87. zerochat_runtime/assets/js/storage-db.js +144 -0
  88. zerochat_runtime/assets/js/tool-cards.js +330 -0
  89. zerochat_runtime/assets/js/tool-security.js +653 -0
  90. zerochat_runtime/assets/js/tools/README.md +50 -0
  91. zerochat_runtime/assets/js/tools/builtin/agent-checkpoint.tool.js +212 -0
  92. zerochat_runtime/assets/js/tools/builtin/download-pdf.tool.js +111 -0
  93. zerochat_runtime/assets/js/tools/builtin/execute-javascript.tool.js +219 -0
  94. zerochat_runtime/assets/js/tools/builtin/fetch-web-page.tool.js +112 -0
  95. zerochat_runtime/assets/js/tools/builtin/list-documents.tool.js +117 -0
  96. zerochat_runtime/assets/js/tools/builtin/read-knowledge-chunk.tool.js +129 -0
  97. zerochat_runtime/assets/js/tools/builtin/read-knowledge-image.tool.js +95 -0
  98. zerochat_runtime/assets/js/tools/builtin/render-chart.tool.js +90 -0
  99. zerochat_runtime/assets/js/tools/builtin/search-knowledge-base.tool.js +124 -0
  100. zerochat_runtime/assets/js/tools/builtin/search-web.tool.js +125 -0
  101. zerochat_runtime/assets/js/tools/tool-manifest.js +53 -0
  102. zerochat_runtime/assets/js/tools/tool-runtime.js +77 -0
  103. zerochat_runtime/assets/js/ui-composer.js +319 -0
  104. zerochat_runtime/assets/js/ui-conversation.js +655 -0
  105. zerochat_runtime/assets/js/ui-dialogs.js +132 -0
  106. zerochat_runtime/assets/js/ui-generation-status.js +119 -0
  107. zerochat_runtime/assets/js/ui-inspector.js +804 -0
  108. zerochat_runtime/assets/js/ui-mcp.js +604 -0
  109. zerochat_runtime/assets/js/ui-profiles.js +824 -0
  110. zerochat_runtime/assets/js/ui-reasoning.js +146 -0
  111. zerochat_runtime/assets/js/ui-settings.js +825 -0
  112. zerochat_runtime/assets/js/ui-shell.js +215 -0
  113. zerochat_runtime/assets/js/ui-sidebar.js +429 -0
  114. zerochat_runtime/assets/js/ui-telemetry.js +404 -0
  115. zerochat_runtime/assets/js/ui-transfer.js +262 -0
  116. zerochat_runtime/assets/js/utils.js +216 -0
  117. zerochat_runtime/assets/js/vendor/orama.browser.js +11 -0
  118. zerochat_runtime/assets/js/web-browser.js +569 -0
  119. zerochat_runtime/assets/js/web-search.js +519 -0
  120. zerochat_runtime/assets/manifest.webmanifest +20 -0
  121. zerochat_runtime/assets/services/dummy_mcp/dummy_mcp_server.py +47 -0
  122. zerochat_runtime/assets/services/dummy_mcp/service.json +22 -0
  123. zerochat_runtime/assets/services/lsp/installer.json +9 -0
  124. zerochat_runtime/assets/services/lsp/service.json +22 -0
  125. zerochat_runtime/assets/services/memory/installer.json +9 -0
  126. zerochat_runtime/assets/services/memory/service.json +24 -0
  127. zerochat_runtime/assets/services/playwright/installer.json +10 -0
  128. zerochat_runtime/assets/services/playwright/service.json +39 -0
  129. zerochat_runtime/assets/sw.js +164 -0
  130. zerochat_runtime/assets/zerochat.html +671 -0
@@ -0,0 +1,359 @@
1
+ <!DOCTYPE html>
2
+ <html lang="es">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Configuración de WebLLM y WebGPU · Ayuda de ZeroChat</title>
7
+ <meta name="description" content="Guía de configuración técnica para ejecutar modelos locales en el navegador mediante WebLLM y WebGPU en ZeroChat.">
8
+ <link rel="stylesheet" href="help.css">
9
+ <style>
10
+ .browser-grid {
11
+ display: grid;
12
+ grid-template-columns: 1fr;
13
+ gap: 1.5rem;
14
+ }
15
+ @media (min-width: 768px) {
16
+ .browser-grid {
17
+ grid-template-columns: 1fr 1fr;
18
+ }
19
+ }
20
+ .spec-table {
21
+ width: 100%;
22
+ border-collapse: collapse;
23
+ margin: 1rem 0;
24
+ font-size: 0.9rem;
25
+ }
26
+ .spec-table th, .spec-table td {
27
+ border: 1px solid var(--border-color);
28
+ padding: 0.6rem 0.85rem;
29
+ text-align: left;
30
+ }
31
+ .spec-table th {
32
+ background: var(--bg-card-subtle);
33
+ font-weight: 600;
34
+ }
35
+ .icon-inline {
36
+ display: inline-block;
37
+ vertical-align: -0.15em;
38
+ width: 1.1em;
39
+ height: 1.1em;
40
+ stroke-width: 2;
41
+ stroke: currentColor;
42
+ fill: none;
43
+ }
44
+ </style>
45
+ </head>
46
+ <body>
47
+ <div class="container">
48
+ <header>
49
+ <div class="header-top">
50
+ <a href="index.html" class="logo-badge">
51
+ <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>
52
+ ZeroChat Docs
53
+ </a>
54
+ <div class="header-actions">
55
+ <a href="en/webllm.html" class="top-nav-link">English 🌐</a>
56
+ <a href="index.html" class="top-nav-link">← Volver al Índice</a>
57
+ </div>
58
+ </div>
59
+ <h1>Configuración de WebLLM y WebGPU</h1>
60
+ <p class="subtitle">Guía de preparación técnica para la ejecución local de modelos de Inteligencia Artificial directamente en tu navegador mediante la GPU.</p>
61
+ </header>
62
+
63
+ <div class="card">
64
+ <h2>¿Qué es WebLLM y qué ventajas ofrece?</h2>
65
+ <p>
66
+ <strong>WebLLM</strong> es una tecnología que ejecuta modelos de lenguaje (LLM) íntegramente dentro del navegador web aprovechando la tarjeta gráfica (GPU) mediante la API estándar <strong>WebGPU</strong>.
67
+ </p>
68
+ <ul>
69
+ <li><strong>Privacidad absoluta:</strong> Las preguntas y respuestas nunca salen de tu ordenador; no hay servidores intermedios recopilando datos.</li>
70
+ <li><strong>Sin costes ni suscripciones:</strong> No requiere claves API de pago ni infraestructuras de backend externas.</li>
71
+ <li><strong>Operación sin conexión:</strong> Una vez descargado el modelo en la caché local del navegador (Cache Storage), funciona incluso sin conexión a Internet.</li>
72
+ </ul>
73
+ </div>
74
+
75
+ <div class="card">
76
+ <h2>Requisitos Previos de Hardware</h2>
77
+ <p>WebGPU requiere compatibilidad gráfica y memoria de vídeo (VRAM) adecuada según el tamaño del modelo seleccionado:</p>
78
+ <table class="spec-table">
79
+ <thead>
80
+ <tr>
81
+ <th>Tamaño de Modelo</th>
82
+ <th>VRAM recomendada</th>
83
+ <th>Ejemplos disponibles</th>
84
+ </tr>
85
+ </thead>
86
+ <tbody>
87
+ <tr>
88
+ <td><strong>0.5B – 1.5B</strong></td>
89
+ <td>~1.0 GB a 1.8 GB</td>
90
+ <td>Qwen2.5-0.5B, Llama-3.2-1B, SmolLM2-1.7B</td>
91
+ </tr>
92
+ <tr>
93
+ <td><strong>3B – 4B</strong></td>
94
+ <td>~2.5 GB a 3.5 GB</td>
95
+ <td>Llama-3.2-3B, Phi-3.5-mini-instruct</td>
96
+ </tr>
97
+ <tr>
98
+ <td><strong>7B – 8B</strong></td>
99
+ <td>~5.0 GB a 6.5 GB</td>
100
+ <td>Llama-3.1-8B-Instruct, Mistral-7B-Instruct</td>
101
+ </tr>
102
+ </tbody>
103
+ </table>
104
+ <div class="alert alert-info">
105
+ <strong>Nota:</strong> Los adaptadores gráficos modernos (NVIDIA, AMD Radeon, Apple Silicon M1/M2/M3/M4 e Intel Iris Xe/Arc) cuentan con soporte nativo de WebGPU con los controladores oficiales actualizados.
106
+ </div>
107
+ </div>
108
+
109
+ <h2>Configuración por Navegador</h2>
110
+ <div class="browser-grid">
111
+
112
+ <!-- Google Chrome / Edge / Brave -->
113
+ <div class="card">
114
+ <h3>Google Chrome, Edge y Chromium</h3>
115
+ <p>Los navegadores basados en Chromium ofrecen el mejor rendimiento con WebGPU.</p>
116
+
117
+ <ol>
118
+ <li>
119
+ <strong>Activa la aceleración por hardware:</strong>
120
+ <p>Ve a Configuración &gt; Sistema y asegúrate de activar <em>"Usar aceleración por hardware cuando esté disponible"</em>.</p>
121
+ <div class="code-box">
122
+ <code>chrome://settings/system</code>
123
+ <button class="btn-copy" onclick="copyText('chrome://settings/system', this)">Copiar</button>
124
+ </div>
125
+ </li>
126
+
127
+ <li>
128
+ <strong>Habilitar WebGPU no seguro (Recomendado para máxima compatibilidad):</strong>
129
+ <p>Pega en la barra de direcciones, cambia el valor a <strong>Enabled</strong> y reinicia el navegador:</p>
130
+ <div class="code-box">
131
+ <code>chrome://flags/#enable-unsafe-webgpu</code>
132
+ <button class="btn-copy" onclick="copyText('chrome://flags/#enable-unsafe-webgpu', this)">Copiar</button>
133
+ </div>
134
+ </li>
135
+
136
+ <li>
137
+ <strong>Interoperabilidad WebGPU en Linux (Recomendado en Linux y Wayland):</strong>
138
+ <p>En Linux (especialmente con Wayland o gráficas dedicadas NVIDIA/AMD), activa esta opción para conectar el cómputo de WebGPU directamente con la ventana del navegador sin sobrecargar la CPU:</p>
139
+ <div class="code-box">
140
+ <code>chrome://flags/#force-enable-webgpu-interop</code>
141
+ <button class="btn-copy" onclick="copyText('chrome://flags/#force-enable-webgpu-interop', this)">Copiar</button>
142
+ </div>
143
+ </li>
144
+
145
+ <li>
146
+ <strong>Comprobar el estado de la GPU:</strong>
147
+ <p>Abre el panel de diagnóstico y verifica que <em>WebGPU</em> figure como <em>"Hardware accelerated"</em>:</p>
148
+ <div class="code-box">
149
+ <code>chrome://gpu</code>
150
+ <button class="btn-copy" onclick="copyText('chrome://gpu', this)">Copiar</button>
151
+ </div>
152
+ </li>
153
+ </ol>
154
+ </div>
155
+
156
+ <!-- Mozilla Firefox -->
157
+ <div class="card">
158
+ <h3>Mozilla Firefox</h3>
159
+ <p>WebGPU está en fase de despliegue activo en Firefox y requiere habilitar parámetros específicos:</p>
160
+
161
+ <ol>
162
+ <li>
163
+ <strong>Accede al editor de configuración avanzada:</strong>
164
+ <p>Escribe en la barra de direcciones y pulsa <em>"Aceptar el riesgo y continuar"</em>:</p>
165
+ <div class="code-box">
166
+ <code>about:config</code>
167
+ <button class="btn-copy" onclick="copyText('about:config', this)">Copiar</button>
168
+ </div>
169
+ </li>
170
+
171
+ <li>
172
+ <strong>Habilita la API WebGPU:</strong>
173
+ <p>Busca este parámetro y asegúrate de que esté configurado como <strong>true</strong>:</p>
174
+ <div class="code-box">
175
+ <code>dom.webgpu.enabled</code>
176
+ <button class="btn-copy" onclick="copyText('dom.webgpu.enabled', this)">Copiar</button>
177
+ </div>
178
+ </li>
179
+
180
+ <li>
181
+ <strong>Ignorar lista de bloqueo de controladores (Recomendado en Linux/Windows):</strong>
182
+ <p>Permite a Firefox utilizar WebGPU incluso si el controlador no está verificado en la lista oficial:</p>
183
+ <div class="code-box">
184
+ <code>gfx.webgpu.ignore-status</code>
185
+ <button class="btn-copy" onclick="copyText('gfx.webgpu.ignore-status', this)">Copiar</button>
186
+ </div>
187
+ </li>
188
+
189
+ <li>
190
+ <strong>Comprobar estado en Firefox:</strong>
191
+ <p>Revisa la sección <em>Gráficos &gt; WebGPU</em> para confirmar la detección del adaptador:</p>
192
+ <div class="code-box">
193
+ <code>about:support</code>
194
+ <button class="btn-copy" onclick="copyText('about:support', this)">Copiar</button>
195
+ </div>
196
+ </li>
197
+ </ol>
198
+ </div>
199
+
200
+ </div>
201
+
202
+ <div class="card">
203
+ <h2>Cómo usar WebLLM en ZeroChat</h2>
204
+ <ol>
205
+ <li>En ZeroChat, abre la ventana de <strong>Mantenimiento de Perfiles</strong>.</li>
206
+ <li>Selecciona el tipo de API <strong>WebLLM (local)</strong>.</li>
207
+ <li>
208
+ <strong>Si ya tienes modelos descargados:</strong>
209
+ Aparecerán automáticamente como los primeros de la lista en el combo de selección. Puedes escoger cualquiera de ellos y guardar el perfil directamente sin necesidad de pulsar <em>Query</em>.
210
+ </li>
211
+ <li>
212
+ <strong>Para descargar un nuevo modelo:</strong>
213
+ Pulsa el botón <strong>Query</strong>. Se desplegará el catálogo de modelos disponibles con sus requisitos de memoria VRAM. Pulsa el icono de descarga junto al modelo deseado y espera a que termine la compilación de shaders.
214
+ </li>
215
+ <li>
216
+ Una vez completada la descarga, el modelo quedará marcado como <em>"En caché"</em> y guardado permanentemente en el navegador.
217
+ </li>
218
+ </ol>
219
+ </div>
220
+
221
+ <div class="card">
222
+ <h2>Parámetros Avanzados de Rendimiento WebGPU</h2>
223
+ <p>
224
+ Al configurar un perfil con el proveedor <strong>WebLLM</strong>, junto al selector de modelo encontrarás un botón con icono de engranaje que abre el panel de parámetros avanzados de rendimiento. Estos desplegables permiten adaptar el consumo de VRAM y la velocidad de inferencia a la potencia de tu GPU:
225
+ </p>
226
+ <ul>
227
+ <li>
228
+ <strong>Ventana de contexto (<code>context_window_size</code>):</strong> Desplegable para seleccionar el tamaño máximo de tokens en la KV Cache (por ejemplo: 2048, 4096, 8192, 16384, 32768). Por defecto en navegadores suele venir limitado a 2048 o 4096 para evitar fallos de memoria en GPUs integradas. Si tu GPU dispone de abundante VRAM, aumentarlo permite mantener conversaciones más largas y procesar documentos extensos sin truncado.
229
+ </li>
230
+ <li>
231
+ <strong>Bloque de prefill (<code>prefill_chunk_size</code>):</strong> Desplegable para seleccionar el número de tokens que la GPU procesa en paralelo durante la fase de carga del prompt (512, 1024, 2048, 4096). Un valor mayor aprovecha mejor el paralelismo de GPUs dedicadas potentes, acelerando el tiempo hasta el primer token (TTFT).
232
+ </li>
233
+ </ul>
234
+ <p>
235
+ La primera opción de cada desplegable es <em>"Por defecto del modelo"</em> (<code>default</code>), con la que ZeroChat respetará la configuración predeterminada del modelo. Al guardar el perfil, estos parámetros se conservan asociados a la configuración de la conexión.
236
+ </p>
237
+ </div>
238
+
239
+ <div class="card">
240
+ <h2>Cómo revertir los cambios y restaurar la configuración por defecto</h2>
241
+ <p>
242
+ Si deseas deshacer las modificaciones técnicas realizadas en tu navegador o en ZeroChat y regresar a los valores predeterminados de fábrica, sigue estos pasos según tu navegador:
243
+ </p>
244
+
245
+ <h3>1. Google Chrome, Microsoft Edge y navegadores Chromium</h3>
246
+ <ul>
247
+ <li>
248
+ <strong>Restablecer el flag de WebGPU específico:</strong>
249
+ <p>Accede de nuevo a la dirección del flag y selecciona <strong>Default</strong> en el selector desplegable:</p>
250
+ <div class="code-box">
251
+ <code>chrome://flags/#enable-unsafe-webgpu</code>
252
+ <button class="btn-copy" onclick="copyText('chrome://flags/#enable-unsafe-webgpu', this)">Copiar</button>
253
+ </div>
254
+ <p>Pulsa el botón <strong>Relaunch</strong> (Reiniciar) que aparecerá en la parte inferior para reiniciar el navegador con la configuración por defecto.</p>
255
+ </li>
256
+ <li>
257
+ <strong>Restablecer todos los flags experimentales:</strong>
258
+ <p>Si modificaste varios parámetros y deseas devolver todos los flags a su estado de fábrica, visita la página principal de flags y haz clic en el botón <strong>"Reset all"</strong> (o <em>"Restablecer todo"</em>) en la esquina superior derecha:</p>
259
+ <div class="code-box">
260
+ <code>chrome://flags</code>
261
+ <button class="btn-copy" onclick="copyText('chrome://flags', this)">Copiar</button>
262
+ </div>
263
+ </li>
264
+ <li>
265
+ <strong>Aceleración por hardware:</strong>
266
+ <p>En <code>chrome://settings/system</code>, puedes volver a marcar o desmarcar la opción <em>"Usar aceleración por hardware cuando esté disponible"</em> según tu preferencia habitual.</p>
267
+ </li>
268
+ </ul>
269
+
270
+ <h3>2. Mozilla Firefox</h3>
271
+ <ul>
272
+ <li>
273
+ <strong>Acceder a la configuración avanzada:</strong>
274
+ <p>Escribe en la barra de direcciones y acepta la advertencia:</p>
275
+ <div class="code-box">
276
+ <code>about:config</code>
277
+ <button class="btn-copy" onclick="copyText('about:config', this)">Copiar</button>
278
+ </div>
279
+ </li>
280
+ <li>
281
+ <strong>Restablecer las preferencias modificadas:</strong>
282
+ <p>Busca cada parámetro modificado. Verás que su nombre figura en <strong>negrita</strong>, lo que indica que tiene un valor personalizado distinto del predeterminado:</p>
283
+ <ul>
284
+ <li><code>dom.webgpu.enabled</code> (valor predeterminado de fábrica: <strong>false</strong>)</li>
285
+ <li><code>gfx.webgpu.ignore-status</code> (valor predeterminado de fábrica: <strong>false</strong> o inexistente)</li>
286
+ </ul>
287
+ <p>Haz clic en el botón <strong>Restablecer</strong> (icono de flecha curva hacia atrás a la derecha de la fila) o haz doble clic para que regrese a <code>false</code> y deje de mostrarse en negrita.</p>
288
+ </li>
289
+ <li>
290
+ <strong>Reiniciar el navegador:</strong>
291
+ <p>Cierra y vuelve a abrir Firefox para que el subsistema gráfico se reinicie con la configuración por defecto.</p>
292
+ </li>
293
+ </ul>
294
+
295
+ <h3>3. Liberar espacio en disco (Eliminar modelos descargados de la caché)</h3>
296
+ <p>
297
+ Los modelos locales de WebLLM se almacenan en el almacenamiento persistente del navegador (<em>Cache Storage</em> / <em>IndexedDB</em>) y pueden ocupar varios gigabytes. Si deseas eliminarlos para recuperar espacio en disco:
298
+ </p>
299
+ <ul>
300
+ <li>
301
+ <strong>En Google Chrome, Edge y Chromium:</strong>
302
+ <ol>
303
+ <li>Haz clic en el icono de información/candado o ajustes a la izquierda de la barra de direcciones mientras estás en ZeroChat.</li>
304
+ <li>Entra en <em>"Configuración del sitio"</em> y haz clic en <strong>"Borrar datos"</strong>.</li>
305
+ <li>De manera alternativa, pulsa <kbd>F12</kbd> &gt; pestaña <strong>Application</strong> &gt; apartado <strong>Storage</strong> &gt; botón <strong>"Clear site data"</strong>.</li>
306
+ </ol>
307
+ </li>
308
+ <li>
309
+ <strong>En Mozilla Firefox:</strong>
310
+ <ol>
311
+ <li>Ve a Ajustes &gt; sección <em>Privacidad y Seguridad</em> &gt; <em>Cookies y datos del sitio</em>.</li>
312
+ <li>Haz clic en <strong>"Administrar datos..."</strong>, busca el dominio de ZeroChat y pulsa <strong>"Eliminar los seleccionados"</strong>.</li>
313
+ <li>De manera alternativa, pulsa <kbd>F12</kbd> &gt; pestaña <strong>Almacenamiento</strong> &gt; sección <strong>Almacenamiento en caché</strong>, haz clic derecho sobre las entradas <code>webllm/model</code> y pulsa <strong>Eliminar</strong>.</li>
314
+ </ol>
315
+ </li>
316
+ </ul>
317
+ </div>
318
+
319
+ <div class="card">
320
+ <h2>Resolución de Problemas Frecuentes y Compatibilidad</h2>
321
+ <p>ZeroChat ejecuta WebLLM mediante un Web Worker clásico autocontenido en memoria, garantizando compatibilidad total tanto en Google Chrome como en Mozilla Firefox de forma completamente estática (sin requerir compilaciones locales ni flags especiales). El runtime de JavaScript se almacena de forma persistente en <em>Cache Storage</em> y se actualiza periódicamente de manera automática cada 7 días siempre que haya conexión disponible (con respaldo <em>offline</em> transparente si no hay red).</p>
322
+ <p>Configuración → Borrar todo elimina los datos del origen actual, incluidos RAG, adjuntos, modelos descargados, IndexedDB, Cache Storage y archivos privados del navegador. Cierra las otras pestañas antes de confirmar. El borrado es irreversible y afecta a aplicaciones que compartan el origen. Repite la operación en cada origen HTTP o HTTPS que hayas utilizado. No elimina archivos descargados en tu ordenador, cookies HttpOnly ni la caché HTTP interna del navegador.</p>
323
+ <p>Si la preparación falla, la fila del modelo muestra el detalle del error recibido de WebLLM. Copia ese mensaje completo para diagnosticar el acceso a los recursos de hardware y a la aceleración WebGPU de tu GPU.</p>
324
+ <ul>
325
+ <li>
326
+ <strong>"WebGPU no está disponible en este navegador":</strong> Comprueba que tu navegador esté actualizado a la última versión y que los flags de WebGPU indicados arriba estén habilitados.
327
+ </li>
328
+ <li>
329
+ <strong>Error por memoria insuficiente (Out of Memory):</strong> Si el navegador se bloquea o recarga durante la compilación, selecciona un modelo más ligero (por ejemplo, de 0.5B a 1.5B) o cierra pestañas pesadas que utilicen aceleración 3D.
330
+ </li>
331
+ <li>
332
+ <strong>Navegación Privada / Modo Incógnito:</strong> Los modos de incógnito limitan o borran la caché al cerrar la ventana. Para conservar los modelos descargados permanentemente, utiliza una ventana normal de navegación.
333
+ </li>
334
+ </ul>
335
+ </div>
336
+
337
+ <nav class="page-navigation" aria-label="Navegación de ayuda">
338
+ <a href="profiles.html" class="nav-button prev">
339
+ <span class="nav-direction">← Anterior</span>
340
+ <span class="nav-title">Perfiles y Proveedores</span>
341
+ </a>
342
+ <a href="index.html" class="nav-button index">
343
+ <span class="nav-direction">Índice</span>
344
+ <span class="nav-title">Ver todos los temas</span>
345
+ </a>
346
+ <a href="tools-agent.html" class="nav-button next">
347
+ <span class="nav-direction">Siguiente →</span>
348
+ <span class="nav-title">Modo Agente y Herramientas</span>
349
+ </a>
350
+ </nav>
351
+
352
+ <footer>
353
+ <p>ZeroChat · Cliente Web Universal de IA · Manual de Usuario</p>
354
+ </footer>
355
+ </div>
356
+
357
+ <script src="help.js"></script>
358
+ </body>
359
+ </html>