A modern web-based desktop environment inspired by classic macOS, built with a cutting-edge web stack and AI. Features multiple built-in applications, a familiar desktop interface, and a system context-aware AI agent. Works on all devices—including mobile, tablet, and desktop.

• Authentic macOS and Windows-style desktop interactions
• Multi-instance window manager with support for multiple windows per app
• Cross-device window resizers
• Menubar with app-specific menus (or taskbar + Start menu on Windows themes)
• Icon and list views
• Customizable wallpapers (photos, patterns, or videos)
• System-wide sampled and synthesizer sound effects
• System-wide UI, Chats, and Terminal sounds
• System-wide Ryo AI, with tool calls and context of running applications
• Virtual file system with local storage persistence and one-click Backup / Restore

• Four switchable themes: System 7, Aqua (Mac OS X), Windows XP, Windows 98
  • Menu & chrome: mac themes use a top menubar with traffic-light controls; Windows themes use a bottom taskbar with a Start menu and classic window buttons
  • Fonts & icons: theme-specific system fonts and ThemedIcon assets for authentic look
  • Wallpapers: theme-specific default photo/tile/video wallpapers
  • Controls: select, dropdowns, buttons, and resizers are styled per theme, including mobile-safe resizers for XP/98

• Finder: File manager with Quick Access & Storage Info
• TextEdit: Rich text editing with markdown support and task lists
  • Multi-window support - open multiple documents simultaneously
  • Each window maintains independent document state
  • Automatic instance management and document tracking
  • Smart file opening with existing window detection
• MacPaint: Classic bitmap graphics editor
  • Drawing tools (pencil, brush, spray, eraser)
  • Shape tools (rectangle, oval, line)
  • Fill patterns and colors
  • Spray tool simulates a dithered airbrush and defaults to a larger size
  • Brush tool starts with a thicker stroke while the pencil starts thin
  • 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 browser with a temporal twist
  • Time Machine view to explore snapshots across different years
  • AI reimagines pre-1996 sites and generates futuristic designs
  • Save favorites by year and share time-travel links
• Chats: AI-powered chat with speech & tool calling
  • Natural conversation with Ryo AI
  • Public and private chat rooms with real-time messaging via Pusher
  • Join public chat rooms with @ryo mentions for AI-powered responses
  • Private conversations with other users
  • Real-time message synchronization across devices
  • Unread message notifications and counters
  • Push-to-talk voice messages with real-time transcription
  • Text-to-speech for AI responses with word highlighting
  • Control apps and edit documents via chat commands
  • Nudge system (👋) with context-aware responses
  • ryOS FM DJ mode - when music plays, Ryo becomes a radio DJ
  • Tool calling capabilities for system integration
  • Save transcript to Markdown
  • Speech synthesis with volume controls
  • User authentication system with secure token-based sessions
  • Message deletion and moderation capabilities
• 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
  • Time-synced lyrics with multi-language translation
  • Interactive lyric offset adjustment via gestures
  • Multiple lyric alignment modes (Focus Three, Alternating, Center)
  • Chinese character variants (Traditional/Simplified) and Korean romanization
  • Fullscreen lyrics mode with video support
  • Real-time lyric highlighting during playback
  • Library persisted locally for offline playback
• Applet Store: Discover, install, and share HTML applets
  • Browse community-created applets in a curated store
  • Featured applets and update notifications
  • One-click install and update system
  • Share your own applets with shareable links
  • View applets in detail before installing
  • Search and filter applets by name or creator
  • Automatic update detection for installed applets
  • Bulk update all applets at once
  • Import/export applets as .app files (gzipped JSON) or HTML
  • Applet authentication bridge for secure API access
  • Custom window sizes per applet
  • Integration with Finder for file management
  • Create applets via ryOS Chat AI assistant

project/
├── public/           # Static assets
│   ├── assets/       # Videos, sounds, and other media
│   ├── fonts/        # Font files
│   ├── icons/        # UI icons organized by category
│   ├── patterns/     # Pattern files
│   └── wallpapers/   # Wallpaper images (photos and tiles)
├── src/
│   ├── apps/         # Individual application modules
│   │   └── [app-name]/ # Each app has its own directory
│   │       ├── components/ # App-specific components
│   │       ├── hooks/      # Custom hooks specific to the app
│   │       └── utils/      # Utility functions for the app
│   ├── components/   # Shared React components
│   │   ├── dialogs/    # Dialog components
│   │   ├── layout/     # Layout components
│   │   ├── shared/     # Shared components across applications
│   │   └── ui/         # UI components (shadcn components)
│   ├── config/       # Configuration files
│   ├── contexts/     # React context providers
│   ├── hooks/        # Custom React hooks
│   ├── lib/          # Libraries and utilities
│   ├── stores/       # State management (e.g., Zustand stores)
│   ├── styles/       # CSS and styling utilities
│   ├── types/        # TypeScript type definitions
│   └── utils/        # Utility functions
├── api/              # API endpoints
│   ├── applet-ai.ts  # AI API for applets with rate limiting
│   ├── share-applet.ts # Applet sharing and storage
│   ├── chat.ts       # Main AI chat endpoint
│   ├── chat-rooms.js # Chat room management and real-time messaging
│   ├── audio-transcribe.ts # Speech-to-text transcription
│   ├── speech.ts     # Text-to-speech synthesis
│   ├── lyrics.ts     # Lyric fetching and translation
│   ├── ie-generate.ts # Internet Explorer AI site generation
│   └── utils/        # API utilities (CORS, rate limiting, AI models)
└── ...config files   # e.g., vite.config.ts, tsconfig.json, package.json

• AI Integration: Multiple AI models (OpenAI, Anthropic, Google) via Vercel AI SDK
• Real-time Communication: Pusher for chat rooms and live updates
• Rate Limiting: Redis-based rate limiting for API endpoints
• Authentication: Token-based authentication with Redis storage
• Edge Functions: Vercel Edge Runtime for low-latency API responses

• TypeScript for type safety
• React 18 with hooks and context
• Zustand for state management
• Tailwind CSS for utility-first styling
• shadcn/ui components built on Radix UI primitives
• Framer Motion for animations
• Lucide React for icons
• TipTap for rich text editing
• Three.js for 3D graphics (Galaxy shader, etc.)
• Tone.js for audio synthesis

• IndexedDB for local file system and document storage
• LocalStorage for user preferences and app state
• Redis (Upstash) for server-side data (chat rooms, applets, auth tokens)

• Vite for fast development and building
• ESLint for code quality
• Bun as package manager and runtime
• Vercel for deployment and hosting

• bun dev - Start development server
• bun run build - Build for production
• bun run lint - Run ESLint
• bun run preview - Preview production build
• bun run generate:icons - Generate icon manifest
• bun run generate:wallpapers - Generate wallpaper manifest
• bun run launch-kiosk - Launch in kiosk mode

• Applet Store: Browse, install, and share HTML applets created by the community
• Applet AI API: Dedicated AI endpoint for applets with rate limiting (15-50 text requests/hour, 1-12 image requests/hour)
• Applet Authentication: Secure token bridge for applets to access user authentication
• Update System: Automatic detection and one-click updates for installed applets
• Import/Export: Support for .app files (gzipped JSON with metadata) and plain HTML

• Real-time Messaging: Public and private chat rooms with Pusher integration
• User Authentication: Secure login system with token-based sessions
• Unread Tracking: Message counters and notifications for rooms
• Message Management: Delete messages and moderate rooms
• Private Conversations: One-on-one private messaging

• Multi-window TextEdit: Open multiple documents simultaneously with independent state
• iPod Lyrics: Interactive lyric offset adjustment with gesture support
• Finder Integration: Applets appear in Finder with metadata and sharing support
• Theme Improvements: Enhanced Windows XP/98 theme support with mobile-safe controls

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request.