ryokun6 / ryos

ryOS — A Web-Based Agentic AI OS, made with Cursor A modern web-based desktop environment inspired by classic macOS and Windows, built with React, TypeScript, and AI. Features multiple built-in applications, a familiar desktop interface, and a system-aware AI assistant. Works on all devices—desktop, tablet, and mobile. **Read ryOS Docs** — Architecture, API reference, and developer guides Features Desktop Environment • Authentic macOS and Windows-style desktop interactions • Multi-instance window manager with drag, resize, and minimize • Customizable wallpapers (photos, patterns, or videos) • System-wide sound effects and AI assistant (Ryo) • Virtual file system with local storage persistence and backup/restore Themes • **System 7** — Classic Mac OS look with top menubar and traffic-light controls • **Aqua** — Mac OS X style with modern aesthetics • **Windows XP** — Bottom taskbar, Start menu, and classic window controls • **Windows 98** — Retro Windows experience with mobile-safe controls Built-in Applications • **Finder** — File manager with Quick Access, storage info, and smart file detection • **TextEdit** — Rich text editor with markdown, slash commands, and multi-window support • **MacPaint** — Bitmap graphics editor with drawing tools, patterns, and import/export • **Videos** — VCR-style YouTube player with playlist management • **Soundboard** — Record and play custom sounds with waveform visualization • **Synth** — Virtual synthesizer with multiple waveforms, effects, and MIDI support • **Photo Booth** — Camera app with real-time filters and photo gallery • **Internet Explorer** — Time Machine that explores web history via Wayback Machine; AI generates sites for years before 1996 or in the future • **Chats** — AI chat with Ryo, public/private chat rooms, voice messages, and tool calling • **Control Panels** — System preferences: appearance, sounds, backup/restore, and file system management • **Minesweeper** — Classic puzzle game • **Virtual PC** — DOS emulator for classic games (Doom, SimCity, etc.) • **Infinite Mac** — Classic Mac OS emulators (System 1.0 to Mac OS X 10.4) via Infinite Mac • **Terminal** — Unix-like CLI with AI integration ( ) • **iPod** — 1st-gen iPod music player with YouTube import, lyrics, and translation • **Applet Store** — Browse, install, and share community-created HTML applets • **Stickies** — Sticky notes for quick reminders Quick Start • Launch apps from the Finder, Desktop, or Apple/Start menu • Drag windows to move, drag edges to resize • Use Control Panels to customize appearance and sounds • Chat with Ryo AI for help or to control apps • Files auto-save to browser storage Project Structure Tech Stack • **Frontend:** React 19, TypeScript, Tailwind CSS, shadcn/ui, Framer Motion • **Audio:** Tone.js, WaveSurfer.js • **3D:** Three.js (shaders) • **Text Editor:** TipTap • **State:** Zustand • **Storage:** IndexedDB, LocalStorage, Redis (Upstash) • **AI:** OpenAI, Anthropic, Google via Vercel AI SDK • **Real-time:** Pusher • **Build:** Vite, Bun • **Deployment:** Vercel Scripts For local development, starts both the standalone Bun API server and the Vite dev server with an proxy — no Vercel CLI required. Running the API Separately Use this when you only need the API server (e.g. for running tests): The standalone API listens on: • (fallback: , then ) • (fallback: ) You can run API tests directly against it: VPS / self-hosting path ryOS now supports a **single Bun production server** for self-hosting and container platforms like Coolify. That server handles: • • static frontend assets from • SPA deep links • docs clean URLs • optional local websocket realtime Quick self-host start Redis backend options Use **either**: or: Realtime backend options Use **either**: or: Detailed runbook: License AGPL-3.0 — See LICENSE for details. Contributing Contributions welcome! Please submit a Pull Request.