- ryOS — Web-based Desktop Environment
ryOS — Web-based Desktop Environment
The AI Operating System initialized with built-in MCP servers.
内容

ryOS — Web-based Desktop Environment
A modern web-based desktop environment inspired by classic macOS, built with React and modern web technologies. Features multiple built-in applications and a familiar desktop interface. Works on all devices—including mobile, tablet, and desktop.
Tech Stack
- React 18.3 with TypeScript
- Vite 6.0 for blazing fast development
- TailwindCSS 4.0 for styling
- shadcn/ui components
- Framer Motion for animations
- Bun as package manager
- WaveSurfer.js for audio visualization
- Tone.js for audio synthesis
Getting Started
# Install dependencies
bun install
# Start development server
bun dev
# Build for production
bun run build
Features
Desktop Environment
- Authentic macOS-style window management
- Multiple resizable and draggable windows
- Desktop icons and dock
- Window minimize/maximize controls
- Menu bar with application-specific menus
- Customizable wallpapers (photos, patterns, or videos)
- System-wide sound effects
- Local storage persistence
- Optional CRT, Galaxy & Aurora shader effects
- System-wide UI, Chats, and Terminal sounds
- Local storage persistence with one-click Backup / Restore
Built-in Applications
- Finder: File manager with Quick Access & Storage Info
- TextEdit: Rich text editing with markdown support and task lists
- MacPaint: Classic bitmap graphics editor
- Drawing tools (pencil, brush, eraser)
- Shape tools (rectangle, oval, line)
- Fill patterns and colors
- Selection and move tools
- Undo/redo support
- Image file import/export support
- Videos: Retro-style YouTube playlist player
- VCR-style interface with LCD display
- Add and manage YouTube videos
- Playlist management with shuffle and repeat modes
- Scrolling titles and classic CD player controls
- Local storage persistence
- Soundboard: Create and manage custom soundboards
- Record sounds directly from microphone
- Multiple soundboards support
- Waveform visualization
- Keyboard shortcuts (1-9)
- Import/export functionality
- Emoji and title customization
- Enhanced synth effects
- Synth: Virtual synthesizer with retro aesthetics
- Virtual keyboard with computer key support
- Multiple oscillator waveforms (sine, square, sawtooth, triangle)
- Effects including reverb, delay, and distortion
- Customizable synth parameters
- MIDI input support
- Preset saving and loading
- Classic synthesizer UI design
- Photo Booth: Camera app with effects
- Take photos with your webcam
- Multiple photo effects and filters
- Brightness and contrast adjustments
- Photo gallery with thumbnails
- Multi-photo sequence mode
- Export photos to Files
- Real-time filter preview
- Internet Explorer: Classic web browser experience
- Wayback Machine integration for time travel
- Classic UI with modern browsing capabilities
- Historical web content viewing
- Chats: AI-powered chat & rooms
- Natural conversation with Ryo AI
- Join public chat rooms
- Push-to-talk voice messages
- Control apps or edit documents via chat commands
- Save transcript to Markdown
- Control Panels: System preferences & power tools
- Appearance & shader selection (CRT, Galaxy, Aurora)
- UI / typing / Terminal sound toggles
- One-click full Backup / Restore
- Format or reset the virtual file system
- Minesweeper: Classic game implementation
- Virtual PC: DOS game emulator
- Play classic games like Doom and SimCity
- DOS environment emulation
- Game save states
- Terminal: Unix-like CLI with built-in AI
- Familiar commands (ls, cd, cat, touch, vim, edit, …)
- ↑ / ↓ history & auto-completion
- "ryo
" to chat with AI assistant - Open documents in TextEdit or Vim straight from prompt
- Toggle distinctive Terminal sounds in View ▸ Sounds
- iPod: 1st-generation iPod-style music player
- Import any YouTube URL to build your music library
- Classic click-wheel navigation and back-light toggle
- Shuffle and loop playback modes
- Create playlists and organize tracks
- Library persisted locally for offline playback
Core Features
- Window management with draggable, resizable windows & z-index
- Shader-powered backgrounds (CRT scanlines, Galaxy, Aurora)
- System context Ryo AI across Terminal & Chats
- One-click Backup / Restore (localStorage & IndexedDB)
- Local persistence for every app (videos, music, docs…)
- Keyboard shortcuts & mobile-friendly gestures
- Responsive design for mobile and tablet
- Full virtual file system shared by Finder, Terminal, TextEdit & others
- System-wide audio with per-app toggles
- Import / Export for documents, sounds & wallpapers
Project Structure
project/
├── src/
│ ├── apps/ # Individual applications
│ │ ├── base/ # Base app functionality
│ │ ├── finder/ # File system app
│ │ ├── textedit/ # Text editor app
│ │ ├── videos/ # YouTube playlist app
│ │ ├── soundboard/ # Audio recording app
│ │ ├── chats/ # Chat application
│ │ └── minesweeper/# Game implementation
│ ├── components/ # Shared React components
│ │ ├── layout/ # Core layout components
│ │ ├── ui/ # shadcn/ui components
│ │ └── dialogs/ # System dialogs
│ ├── hooks/ # Custom React hooks
│ └── utils/ # Shared utilities
├── api/ # Backend API endpoints
├── public/ # Static assets
└── ...config files
Development
The project uses:
- TypeScript for type safety
- ESLint for code quality
- Tailwind for utility-first CSS
- shadcn/ui components built on Radix UI primitives
- Lucide icons
- Vercel for deployment
Scripts
bun dev- Start development serverbun run build- Build for productionbun run lint- Run ESLintbun run preview- Preview production build
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
推荐的 MCP Server
TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.
Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code
EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.
Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.
AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.
Amap Maps高德地图官方 MCP Server
Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.
WindsurfThe new purpose-built IDE to harness magic
Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.
CursorThe AI Code Editor
MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.
DeepChatYour AI Partner on Desktop
RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.
Serper MCP ServerA Serper MCP Server
BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.
Baidu Map百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs
Howtocook Mcp基于Anduin2017 / HowToCook (程序员在家做饭指南)的mcp server,帮你推荐菜谱、规划膳食,解决“今天吃什么“的世纪难题;
Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"
ChatWiseThe second fastest AI chatbot™
Tavily Mcp
Playwright McpPlaywright MCP server