Wave OS

From Wave Wiki — the open reference for the Wave OS ecosystem.

1. Wave OS Overview

Wave OS is a decentralized cloud operating system powered by Theta EdgeCloud, designed to run powerful AI and compute workloads directly in the browser — no installation required.

Wave OS unifies AI agents, development tools, productivity apps, and decentralized compute into a single cohesive platform. Compute-intensive sessions run on Theta EdgeCloud, giving users censorship-resistant, distributed processing power.

**(Roadmap — not yet live)** Wave OS is designed to eventually run on a $WAVE token-based credit economy (contract deployed at 0x93de35b55ace27cee301184e010de73518950...), where users would earn and spend on-chain credits for compute, storage, and AI inference tasks. Today, credits are managed off-chain through Wave OS's built-in credit system, with on-chain $WAVE integration actively in development.

**(Roadmap — not yet implemented)** Wave OS identity will eventually be anchored by WaveIdentity, a non-transferable NFT-based identity system deployed on the Theta blockchain (contract: 0x4875b2198680738a575c0f14b4588695d80d44a7). This will link each user's wallet to their Wave OS session. This feature is not yet active for user accounts.

2. Mission & Goals

Wave OS exists to democratize access to AI compute. By routing workloads through Theta EdgeCloud's global network of edge nodes, Wave OS eliminates reliance on centralized cloud providers like AWS or Google Cloud.

Wave OS bridges the gap between Theta Network's powerful decentralized infrastructure and everyday users who have no technical background. The average person should never have to deal with API keys, EdgeCloud configurations, wallet gas mechanics, or node setup just to run an AI model or send a decentralized message. Wave OS absorbs that complexity — handling Theta API authentication, edge node routing, TFUEL credit management, and session orchestration behind a simple web interface. What looks like a chat app or an image generator is actually a full decentralized compute pipeline running on Theta's global edge network, with the friction invisible to the user.

The goal is to make decentralized computing feel like using any modern cloud product — sign in, click a button, get results. No CLI, no environment variables, no blockchain knowledge required. Power users and developers can still access the raw Theta APIs and wallet controls underneath, but the default experience is zero-friction. Every feature in Wave OS — from AI image generation to messaging to compute sessions — runs on Theta Network infrastructure without the user ever needing to know it.

3. AI Integration

Wave OS integrates multiple AI systems tailored to each task. Wave Assistant, the OS-wide conversational AI, runs on GLM-5.2 via Theta EdgeCloud — giving it context awareness across your files, wallet, compute sessions, and connected apps. For creative generation tasks, Wave OS taps Theta EdgeCloud's on-demand models: Qwen3 for text, LLaVA for vision, and SDXL Turbo for image synthesis.

Wave Assistant also draws on a dedicated knowledge base of curated Theta Network and dApp reference material — including TNT-20/TNT-721 token standards, smart contract deployment patterns, and IPFS metadata workflows — allowing it to answer blockchain and smart-contract questions with grounded accuracy. Separately, Surge's AI code assistant runs its own 5-layer pipeline (Design System, Tech Stack Matrix, Template Library, Quality Enhancement, Code Guardian) to generate and safely apply code changes, backed by a library of 8 audited Solidity contract templates for on-chain deployment.

When Harbor is connected to a local PC, Wave Assistant can fall back to locally-hosted AI models — such as Ollama (Llama 3, Mistral, Phi-3, etc.) — running directly on the user's hardware. This enables offline-capable AI assistance with zero external API costs, while maintaining full context awareness across the user's Wave OS workspace. Users can also expand the assistant's capabilities by adding their own API keys (BYOK) for OpenAI, Anthropic, or other compatible providers, configured in Settings → Connectors. This three-tier model — Theta EdgeCloud (default), local models via Harbor (offline fallback), and BYOK API keys (premium expansion) — gives users flexibility across cost, privacy, and capability tradeoffs.

4. Apps

4a. Story

Story is a narrative scene builder inside Wave OS for composing animated sequences. **(Roadmap — not yet live)** AI-driven frame and video generation via "Send to AI" is planned but not yet working — no successful video generation has been achieved to date. See the full Story page for details.

4b. Vision

Vision is Wave OS's image generation studio, modeled after Theta Vision. It features a two-panel workspace and real-time GPU telemetry tiles. See the full Vision page for details.

4c. Wave Compute

Wave Compute is a decentralized GPU computing platform for spinning up Theta Edge compute sessions for AI inference, rendering, and data processing. See the full Wave Compute page for details.

4d. Chief of Staff

Chief of Staff is an AI-powered triage and assistant system that monitors system alerts, categorizes them, and notifies the user via Telegram. See the full Chief of Staff page for details.

4e. Wave Token Launchpad

Token Launchpad is a decentralized token creation and management platform for deploying custom tokens on the Theta blockchain, managing holders, and promoting listings. See the full Token Launchpad page for details.

4f. Reef

Reef is a decentralized app marketplace and deployment platform for browsing, installing, and deploying Docker-based apps on Theta Edge nodes. See the full Reef page for details.

4g. Games

Games is an HTML5 game library and player for browsing, playing, and uploading games directly in the browser. See the full Games page for details.

4h. Analytics

Analytics is a website analytics and uptime monitoring suite for tracking page views, visitor metrics, and monitoring endpoint uptime. See the full Analytics page for details.

4i. Email Campaigns

Email Campaigns is an email marketing and subscriber management tool for building lists, scheduling campaigns, and tracking open/click metrics. See the full Email Campaigns page for details.

4j. Link Pages

Link Pages is a link-in-bio and URL shortener tool for creating customizable link pages and short links with click tracking. See the full Link Pages page for details.

4o. Cloud Workstation

Cloud Workstation is a full Arch Linux + Wayland desktop running on Theta EdgeCloud, accessible from the browser via WebRTC. See the full Cloud Workstation page for details.

4p. Wave Suite

Wave Suite is the workspace personalization system for Wave OS, letting users create and switch between multiple desktop configurations. See the full Wave Suite page for details.

4n. Wave Assistant

Wave Assistant is the built-in AI assistant for Wave OS, with context awareness of your files, wallet, compute sessions, and connected apps. See the full Wave Assistant page for details.

4l. Surge

Surge is an AI-powered code editor with a 5-layer generation pipeline, a Monaco editor, and a Smart Contracts panel (which now includes what used to be the standalone Mesh app). See the full Surge page for details.

4m. WaveSwap

WaveSwap is a planned decentralized token swap feature for Wave OS. It is NOT DEPLOYED yet. See the full WaveSwap page for details.

4q. Surf Cloud v2

Surf Cloud v2 is Wave OS's cloud browser platform — a fully managed remote Chromium instance running on Railway with per-user isolated Playwright BrowserContexts. Each user gets their own isolated browser environment with persistent cookies, localStorage, and session state. Powered by Theta EdgeCloud GLM-5.2 for AI element resolution (Stagehand-inspired observe/act/extract patterns). Features CDP recording & replay, React-safe input handling, session persistence, and noVNC branding. Max 50 concurrent sessions, 30-min idle timeout. Connected to Wave OS via the surfAutomateV2 backend function. Live at surf-cloud-production.up.railway.app. GitHub: xBuildy/surf-cloud.

4r. Wave Sidekick v2

Wave Sidekick v2 is a Chrome/Firefox extension (Manifest V3) that brings Wave OS intelligence directly into the browser. Features multi-tab reading (enumerates all open tabs via chrome.tabs.query), page actions (click, fill, scroll, extract on the user's real browser), cross-tab report compilation via Wave Assistant (GLM-5.2), and Surf Cloud v2 session management. Also includes voice input (Web Speech API), TTS, persistent memory, Chief of Staff quick actions, and Theta API key auto-capture. Version 2.0.0 with <all_urls> host permissions. Pairs with Surf Cloud v2: Sidekick acts on the live browser, Surf Cloud handles background automation.

4s. Flows

Flows is Wave OS's visual automation pipeline builder, chaining Trigger, AI, browser-action, and logic nodes into automated workflows. Pipelines can now be listed and run from outside the main Wave OS app (e.g. by the Wave Sidekick browser extension) via a dedicated integration endpoint. See the full Flows page for details.

5. Identity & Wallet System

Wave OS uses a unified identity system that spans both Wave OS and Wave Hi. Users log in once and their identity — including their @handle and linked Theta wallet — syncs across both platforms automatically.

5a. Login

Wave OS supports three login methods: Google OAuth — click "Continue with Google" on the login screen, using your Google account for identity and email; MetaMask Wallet — click "Continue with MetaMask" to connect your Theta/MetaMask wallet, with your wallet address becoming your identity anchor and no password needed; and Email & Password — traditional email/password login, with a confirmation email sent to verify your address. After login, your session is created and your Wave OS email is used as the bridge to Wave Hi for @handle sync.

5b. @Handle System

Every Wave OS user can claim a unique @handle that works across Wave OS and Wave Hi. Your @handle is your public identity (e.g., @eddie); handles are claimed on a first-come, first-served basis. Once claimed, your handle syncs to Wave Hi via the WaveHiProfile entity, and the same @handle appears in Wave OS (profile badge) and Wave Hi (Channels, Feed, Settings). Your handle is linked to your Wave OS email — if you change emails, you keep your handle.

5c. Wallet Linking

Each @handle can be linked to one Theta wallet address. Your wallet address is stored on your WaveHiProfile entity, and you can update your linked wallet at any time from Wave Hi Settings. Wallet updates require cryptographic signature verification — you must prove you own the new wallet before it can be linked. The system prevents linking a wallet that is already bound to another @handle. Wallet is used for TFUEL transactions, Beam file transfers, and decentralized features.

When updating your linked wallet, the system uses a challenge-response signature verification: the user clicks "Update Wallet" in Wave Hi Settings; if they have the MetaMask/Theta Wallet extension, it connects automatically; the app calls updateWallet without a signature, and the backend returns a challenge message such as "I am linking wallet 0x... to my Wave Hi handle @eddie"; the user signs the challenge with their new wallet in one click in MetaMask; the app sends the signature back and the backend verifies it with ethers.js; the signature must match the new wallet address or the update is rejected; and if verified, the wallet is updated on the profile. No one can link a wallet they don't control — the signature proves ownership without exposing private keys.

6. External Products

6a. Wave Dock

Wave Dock is a desktop companion app for Wave OS, built with Electron. It runs as a floating dock on Windows, providing status cards for the Wave OS portal, local Ollama AI, Cloudflare tunnel, and Theta EdgeCloud AI — all from the system tray.

Wave Dock bridges local compute with the cloud: it exposes a local filesystem bridge (waveDockFS), an AI routing bridge (waveDockAI), and automatically detects the user's Ollama instance and Cloudflare tunnel URL for seamless integration with Wave OS Settings.

6b. Wave Harbor

Wave Harbor is a Tauri v2 native desktop agent that provides secure remote file access to Wave OS, with E2E encryption, 2FA pairing, and LAN/WAN access modes. See the full Wave Harbor page for details.

6c. Wave Hi

Wave Hi is a decentralized messaging and social platform built as a Svelte web app, embedded into Wave OS via iframe, featuring Channels, Feed, Mail, and Beam file transfer. See the full Wave Hi page for details.

6d. Wave MCP

Wave MCP is the Model Context Protocol integration layer for Wave OS. It exposes 28 native tools (messaging, memory, Theta compute, entity management) via Railway-hosted SSE proxies, enabling AI assistants like Cursor and Claude to interact directly with Wave OS. See the full Wave MCP page for details.

Authentication uses a credential-based JWT handshake: tokens are signed with a shared HMAC-SHA256 secret and verified by the Wave OS backend using `asServiceRole` for secure tool execution. External users connect via the public proxy (wave-mcp-proxy-production.up.railway.app); internal integrations use the private proxy (wave-mcp.up.railway.app).

6e. Wave Pool

Wave Pool is a collective GPU compute purchasing app for pooling TFUEL to deploy custom open-weight AI models on Theta EdgeCloud at bulk rates, with trustless smart-contract escrow and NFT-based pool slots. See the full Wave Pool page for details.

6f. Surf Cloud v2

Per-user isolated cloud browser with AI element resolution via Theta EdgeCloud GLM-5.2, CDP recording/replay, and React-safe input handling. Each Wave OS user gets their own isolated Playwright BrowserContext with persistent cookies and session state. See the full Surf Cloud v2 wiki page for details.

6g. Wave Sidekick v2

Chrome/Firefox extension (Manifest V3) bringing Wave OS intelligence to your browser. Multi-tab reading, page actions (click/fill/scroll), cross-tab report compilation via Wave Assistant, and Surf Cloud v2 session management. See the full Wave Sidekick v2 wiki page for details.

7. Theta Network Foundation

Wave OS is powered by Theta Network — a decentralized video and compute network. Theta EdgeCloud provides GPU compute-on-demand, allowing Wave OS to run AI inference without owning physical hardware.

[PLACEHOLDER — Add Theta blockchain context]

8. Roadmap

[PLACEHOLDER — Add roadmap items]

[PLACEHOLDER — Add future plans]