{"id":50588229,"url":"https://github.com/kluth/jarvis-os","last_synced_at":"2026-06-05T08:01:44.624Z","repository":{"id":357803211,"uuid":"1238621440","full_name":"kluth/jarvis-os","owner":"kluth","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-23T07:41:43.000Z","size":39773,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2026-05-23T08:06:23.490Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kluth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-14T09:40:24.000Z","updated_at":"2026-05-17T19:05:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kluth/jarvis-os","commit_stats":null,"previous_names":["kluth/jarvis-os"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kluth/jarvis-os","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kluth%2Fjarvis-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kluth%2Fjarvis-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kluth%2Fjarvis-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kluth%2Fjarvis-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kluth","download_url":"https://codeload.github.com/kluth/jarvis-os/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kluth%2Fjarvis-os/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33935514,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-05T08:01:43.458Z","updated_at":"2026-06-05T08:01:44.620Z","avatar_url":"https://github.com/kluth.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# J.A.R.V.I.S. OS (v0.1.0)\n**Just A Rather Very Intelligent System - Operating System**\n\nJARVIS OS is a highly modular, AI-native, voice-first operating system built in Rust. It is designed to autonomously discover, adapt to, and orchestrate its environment—from local hardware to network-distributed IoT services.\n\n---\n\n## 🚀 Core Philosophy\n- **Voice-First:** Interaction is primarily speech-driven. The system communicates its state and capabilities through an audio pipeline.\n- **AI-Native:** The kernel is orchestrated by an autonomous agent capable of synthesizing drivers and intent-based routing.\n- **Extreme Modularity:** \"Operation Small Footprint\" ensures that only strictly necessary modules (GUI, Audio, AI, etc.) are compiled for the specific host hardware.\n- **Autonomous Discovery:** JARVIS proactive identifies environmental endpoints using mDNS, SSDP, and ONVIF.\n\n---\n\n## 🛠 Architectural Highlights\n- **Micro-Kernel Influence:** High isolation via sandboxed WebAssembly (Wasm) drivers.\n- **Multi-Level Feedback Queue (MLFQ):** Priority-based task scheduling ensures real-time responsiveness for voice and safety critical tasks.\n- **Zero-Warning Codebase:** Strictly enforced code quality (Rust, Clippy) with mandatory local validation.\n- **Hardware Agnostic:** Flexible build system supporting various machine profiles (PC, Q35, etc.).\n\n---\n\n## 📸 System Previews (CI Generated)\n*The following images are captured automatically during the CI/CD boot sequence.*\n\n| Boot Stage 1 (Init) | Boot Stage 2 (Discovery) | Final State (Voice Shell) |\n| :---: | :---: | :---: |\n| ![Init](docs/images/screenshot_1.png) | ![Discovery](docs/images/screenshot_2.png) | ![Ready](docs/images/screenshot_3.png) |\n\n*(Note: Real screenshots can be found in the [GitHub Actions Artifacts](https://github.com/kluth/jarvis-os/actions))*\n\n---\n\n## 🛠 Building \u0026 Running\n\n### Prerequisites\n- Rust Nightly (latest)\n- QEMU\n- `ffmpeg` (for visual artifacts)\n\n### Local Validation (Recommended)\nBefore pushing, always run the validation framework:\n```bash\n./scripts/validate.sh\n```\n\n### Build \u0026 Run in QEMU\n```bash\n# Build the image-builder runner\ncd image-builder \u0026\u0026 cargo run -- ../target/x86_64-jarvis_os/debug/jarvis-kernel\n```\n\n### 🐳 Quickstart with Docker (Instant Experience)\nExperience JARVIS OS directly in your browser with a single command:\n```bash\ncurl -sL https://raw.githubusercontent.com/kluth/jarvis-os/main/scripts/run.sh | bash\n```\n*Note: This command pulls our multi-arch Docker image (supporting both x86_64 and ARM64). KVM is highly recommended for optimal performance.*\n\n#### Manual Docker Setup (Optional)\n1. Ensure you have the `jarvis-os.img` in `target/image/`.\n2. Run the container:\n   ```bash\n   cd docker \u0026\u0026 docker-compose up --build -d\n   ```\n3. Open **http://localhost:8080** in your browser.\n\n### Stability Testing (Soak Testing)\nThe project includes a robust stability watchdog to detect intermittent panics and race conditions:\n```bash\n# Run a 10-minute stability soak test locally\n./scripts/stability-watchdog.sh 600\n```\nThe CI/CD pipeline runs these tests in parallel to maximize the probability of triggering latent bugs.\n\n---\n\n## 📜 Development Standards\nSee [GEMINI.md](./GEMINI.md) for detailed engineering standards, the \"One Branch Per Feature\" strategy, and safety protocols for Wakers and Interrupts.\n\n---\n\n## 🛡 Security \u0026 Safety\n- **Safety Gate:** AI decisions are validated by deterministic Rust safety monitors.\n- **Isolation:** Drivers run in a restricted Wasm sandbox to prevent kernel memory corruption.\n- **Lock-Free:** Core OS components use atomic operations to avoid deadlocks in high-concurrency/ISR contexts.\n\n---\n\n© 2026 JARVIS Project. Built with 🦀 for the future.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkluth%2Fjarvis-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkluth%2Fjarvis-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkluth%2Fjarvis-os/lists"}