A web-based agentic AI operating system, ryOS offers a familiar desktop environment inspired by classic macOS and Windows, enhanced with a system-aware AI agent. It provides a unified, cross-device experience with multiple built-in applications and a customizable interface, aiming to blend retro aesthetics with modern web technologies and AI capabilities.

How It Works

ryOS is built on a modern web stack including React 18, TypeScript, and Tailwind CSS, leveraging Vercel AI SDK for AI integration and Pusher for real-time communication. It simulates a desktop experience with a multi-instance window manager, themeable UI (System 7, Aqua, XP, 98), and a virtual file system with local persistence. A core feature is the Ryo AI agent, which provides context-aware assistance, tool calls, and chat functionalities across applications, powered by multiple AI models.

Quick Start & Requirements

Installation and development are managed using Bun. The primary commands are bun dev to start the development server and bun run build for production builds. No specific hardware prerequisites like GPUs or CUDA are mentioned, indicating browser-based execution.

Highlighted Details

• AI Integration: System-wide Ryo AI agent with tool calls and context awareness; AI-powered chat with speech and tool integration; Internet Explorer app simulates AI-generated historical web pages.
• Applet Ecosystem: A curated Applet Store allows users to discover, install, and share community-created HTML applets, featuring an Applet AI API with rate limiting and secure authentication.
• Retro Desktop Simulation: Four distinct themes (System 7, Aqua, XP, 98) with matching fonts, icons, and UI elements; includes classic applications like Finder, TextEdit, MacPaint, a retro video player, soundboard, synth, and a DOS game emulator.
• Cross-Device Compatibility: Designed to function seamlessly across desktop, tablet, and mobile devices.
• Persistence: Utilizes IndexedDB for local file system storage and LocalStorage for user preferences, with Redis for server-side data management.

Maintenance & Community

Contributions are welcomed via pull requests. Specific details regarding maintainers, sponsorships, or dedicated community channels (like Discord/Slack) are not provided in the README.

Licensing & Compatibility

The project is licensed under the AGPL-3.0 License. This strong copyleft license may impose restrictions on integration with closed-source software or commercial use, requiring derivative works to also be open-sourced under the same license.

Limitations & Caveats

The Applet AI API is subject to rate limits (15-50 text requests/hour, 1-12 image requests/hour). The "Virtual PC" application emulates a DOS environment, limiting compatibility to older software. The Internet Explorer application is a simulated browser with AI enhancements, not a fully functional modern web browser.