# โก Zyquo Cloud Web
### *Every cloud model. One beautiful chat. Entirely in your browser.*
**The browser edition of Zyquo Cloud โ 12 AI providers, 170 models, zero backend.
Bring your own keys; nothing ever leaves your device.**
[](https://github.com/spboucher-ai/zyquo-cloud-web/releases)
[](LICENSE)
[](#-contributing)
[](https://github.com/spboucher-ai/zyquo-cloud-web/commits/main)
[](https://react.dev)
[](https://www.typescriptlang.org/)
[](https://vitejs.dev)
[](https://zustand-demo.pmnd.rs/)
[](#-features)
[](#-the-provider-fleet)
[](#-the-provider-fleet)
[](docs/VERIFICATION.md)
[](#-privacy--security-model)
[](#-tech-stack)
[](#-features)
[](#-features)
[](https://github.com/spboucher-ai/zyquo-cloud-web/actions/workflows/ci.yml)
[](https://github.com/spboucher-ai/zyquo-cloud-web/actions/workflows/deploy-pages.yml)
[](https://www.zyquo.cloud)
[](https://github.com/spboucher-ai/zyquo-cloud-web/commits/main)
[](https://github.com/spboucher-ai/zyquo-cloud-web)
**[๐ Open the app โ](https://www.zyquo.cloud)**
---
## ๐ Table of Contents
- [โจ Features](#-features)
- [๐ฐ The Provider Fleet](#-the-provider-fleet)
- [๐ Live Demo](#-live-demo)
- [๐ธ Screenshots](#-screenshots)
- [๐ Privacy & Security Model](#-privacy--security-model)
- [๐งฑ Tech Stack](#-tech-stack)
- [๐ Getting Started](#-getting-started)
- [๐ Available Scripts](#-available-scripts)
- [๐ Project Structure](#-project-structure)
- [โ๏ธ Deployment](#๏ธ-deployment)
- [โ
Verification](#-verification)
- [๐บ Roadmap](#-roadmap)
- [๐ค Contributing](#-contributing)
- [๐ License](#-license)
- [๐ค Author](#-author)
---
## โจ Features
Everything below is implemented and verified in this codebase โ no vaporware.
### ๐ฌ Chat engine
- **Streaming & non-streaming chat** against 12 providers through two faithfully
ported wire clients: one OpenAI `/chat/completions` client (11 providers +
custom endpoints, every quirk handled) and one native **Anthropic Messages
API** client โ over `fetch` + `ReadableStream` with a hand-rolled incremental
**SSE parser** (`event:`/`data:` blocks, keep-alive comments, `[DONE]`,
trailing-event flush).
- **Token-by-token rendering** with a blinking caret, live **elapsed time +
tok/s**, **Stop** (`AbortController` teardown) and **Continue**.
- **Reasoning streams** normalized from every dialect: `reasoning_content`,
`reasoning`, Mistral's array-of-thinking-chunks, DashScope `enable_thinking`,
Anthropic `thinking` blocks โ shown in a collapsible *Thought process* panel.
- **Perplexity citations** (`citations` + `search_results` merged) rendered as
numbered, clickable chips.
- **Auto-retry with backoff** on 429/5xx (honors `Retry-After`), typed
human-readable errors that name the provider, and a CORS-shaped network
error that explains the proxy/Zyquo Router fallback.
- **Auto-titling** after the first exchange using the provider's cheapest
non-reasoning model (native Zyquo Cloud behavior, ported verbatim).
### ๐ The Model Menu
- Command-palette-style picker: **fuzzy search** across name / model ID /
provider, **filter chips** (Vision ยท Tools ยท Reasoning ยท JSON ยท Long context
ยท Cheapest), **Favorites โญ / Recents / Aliases** groups, keyed-providers
first, full keyboard navigation (`โโ`, `โต` use here, `โโต` set default).
- Every row shows capability badges (๐ ๐ง ๐ ), **context window**, and
**$/1M-token pricing** straight from the catalog; un-keyed providers get an
inline **"Add key"** affordance.
### ๐งช Power features
- **Multi-model compare** โ broadcast one prompt to **2โ4 columns**, each
streaming independently with its own stop/copy/regenerate, then **promote
the best answer into your thread**.
- **Variants & branching** โ regenerate keeps the previous answer as a
swipeable variant (`โน 2/3 โบ`); branch a whole conversation from any message;
**edit & resend** forks from an earlier user turn.
- **โK command palette** โ actions (new chat, compare, focus mode, summarize,
duplicate), jump-to-conversation, model switch, personas, templates.
- **`/` slash commands** โ quick tools (`/summarize`, `/translate`,
`/rewrite`, `/explain`) + the full library with `{{input}}` substitution.
- **8 personas** and **56 prompt templates** (8 categories ร 7), ported
verbatim from native Zyquo Cloud.
- **Vision attachments** (drag/drop/paste images โ base64 parts) and **text
file attachments** (injected as fenced context blocks), gated by each
model's real capabilities.
- **Read-aloud** (Web Speech TTS) and **dictation** (SpeechRecognition).
- **Token & cost HUD** โ per-message and per-conversation token counts and
cost estimates from catalog pricing, plus a **context-window usage bar**
with **auto-trim** of the oldest turns at 90% capacity (system prompt kept).
- **Per-conversation parameters** โ temperature, top-p, max tokens,
penalties, reasoning effort, extended thinking โ the panel only shows
controls the active model actually supports; unchecked = provider default,
omitted from the request entirely.
### ๐ Rendering
- GitHub-flavored **Markdown** (tables with zebra rows, task lists,
blockquotes with accent bar), **syntax-highlighted code blocks** with
language label, copy and wrap toggles, **KaTeX math**, and **Mermaid
diagrams** (the ~1 MB renderer lazy-loads only when a diagram appears).
### ๐พ Local-first persistence
- Conversations in **IndexedDB** (schema-versioned, dependency-free wrapper),
keys and settings in namespaced `localStorage`
(`zyquo.cloud.web.*`) โ **surviving reloads and full browser restarts**
(gate-tested).
- **Export / import everything** as JSON (keys strictly opt-in with a
warning), per-conversation Markdown/JSON export, confirm-twice clear-data,
**undo** for deletes.
- Optional **passphrase lock**: the key map encrypted at rest with
**AES-GCM** (PBKDF2, 310k iterations) โ honestly framed as at-rest
protection, not a running-session vault.
### ๐จ Design
- The **ZyquoTheme** design system, ported token-for-token from the native
macOS app โ light flagship theme (`#FAFBFD` / sky-indigo `#4E6AF0`), derived
dark theme, **5 accent choices**, adjustable chat font size and density,
focus mode, `prefers-reduced-motion` respected.
- **Installable PWA** (app-shell precache, 1.15 MB) and fully **responsive** โ
the sidebar becomes a drawer on phones, code blocks scroll internally,
44 pt touch targets.
---
## ๐ฐ The Provider Fleet
| Provider | Models | Wire format | Streaming | Vision | Reasoning | Citations |
|---|:-:|---|:-:|:-:|:-:|:-:|
| ๐ข **OpenAI** | 27 | OpenAI compat | โ
| โ
| โ
| โ |
| ๐ **Anthropic** | 11 | **Messages API** | โ
| โ
| โ
| โ |
| โซ **xAI** | 5 | OpenAI compat | โ
| โ
| โ
| โ |
| ๐ต **Mistral** | 10 | OpenAI compat | โ
| โ
| โ
| โ |
| ๐ด **Google Gemini** | 14 | OpenAI compat | โ
| โ
| โ
| โ |
| ๐ฃ **Alibaba Qwen** | 32 | OpenAI compat | โ
| โ
| โ
| โ |
| ๐ **DeepSeek** | 2 | OpenAI compat | โ
| โ | โ
| โ |
| ๐ **Kimi (Moonshot)** | 12 | OpenAI compat | โ
| โ
| โ
| โ |
| ๐ **Perplexity** | 4 | OpenAI compat | โ
| โ | โ
| โ
|
| ๐งฉ **Together AI** | 16 | OpenAI compat | โ
| โ | โ
| โ |
| ๐ฆ **DeepInfra** | 34 | OpenAI compat | โ
| โ
| โ
| โ |
| โก **Cerebras** | 3 | OpenAI compat | โ
| โ
| โ
| โ |
**All 12 call the provider APIs directly from your browser** โ CORS
feasibility was empirically probed per provider (preflight + authenticated
POST + streaming), documented with official sources in
[`docs/CORS-MATRIX.md`](docs/CORS-MATRIX.md). Anthropic requires its
documented `anthropic-dangerous-direct-browser-access: true` header, which the
client sends. A **per-provider base-URL override** (Settings โ Providers &
Keys) lets you point any provider at your own proxy or a locally running
**Zyquo Router** if a policy ever changes.
---
## ๐ Live Demo
| | URL | Notes |
|---|---|---|
| ๐ **Production** | **https://www.zyquo.cloud** | Primary deployment โ HTTPS, security headers, installable PWA |
| ๐ช **GitHub Pages mirror** | https://spboucher-ai.github.io/zyquo-cloud-web/ | Auto-deployed from `main` by CI |
> Open it, add any provider API key in **Settings โ Providers & Keys** (it
> stays in *your* browser), pick a model, chat. That's the whole onboarding.
---
## ๐ธ Screenshots
| Light (flagship) | Dark |
|:-:|:-:|
|  |  |
| The Model Menu | โK Command Palette |
|:-:|:-:|
|  |  |
| ๐ฑ Mobile |
|:-:|
|
|
## ๐ค Author
**Simon-Pierre Boucher**
๐ซ **Contact:** [contact@spboucher.ai](mailto:contact@spboucher.ai)
*Zyquo Cloud Web is part of the Zyquo family โ native **Zyquo Cloud** (macOS),
**Zyquo Router** (local gateway), and friends.*
โญ **If this project is useful to you, a star makes my day.** โญ