|
Download README.md from LLM-Baremetal/OO: direct link, hf CLI and curl.
- Browser
- Download file 6.32 kB
-
https://huggingface.co/LLM-Baremetal/OO/resolve/main/README.md
- Command line
-
hf download hf://LLM-Baremetal/OO/README.md
-
curl -L -o README.md https://huggingface.co/LLM-Baremetal/OO/resolve/main/README.md
6.32 kB
| license: other | |
| license_name: proprietary-plus-model-notices | |
| tags: | |
| - bare-metal | |
| - x86_64 | |
| - uefi | |
| - operating-system | |
| - llm | |
| - llama3 | |
| - qwen3 | |
| - gguf | |
| - kernel | |
| - freestanding | |
| - autonomous-system | |
| language: | |
| - fr | |
| - en | |
| # OPERATING ORGANISM (OO) — Bare-Metal Cognitive UEFI OS (`x86_64`) | |
| > **Zero Host OS (No Linux, No Windows, No macOS, No POSIX, No libc/malloc runtime)** — Boot directly on physical UEFI `x86_64` hardware or QEMU/OVMF. | |
| **Public Architecture & Qualification Showcase:** https://github.com/DjibyDiop/Operating-Organism | |
| --- | |
| ## 📦 Downloadable Live USB Images | |
| | Image File | Neural Substrate | Recommended RAM | Persistence | | |
| | :--- | :--- | :--- | :--- | | |
| | **`oo-live-usb.img`** | Meta Llama 3.2 1B Instruct (`Q4_0` -> `Q8_0` arena) | `>= 4 GB` RAM (`-m 4G`) | `OO-PERSISTENCE` (32 MiB GPT) | | |
| | **`oo_live_usb_qwen3-14B.img`** | Qwen3-14B (`GGUF v3 Q4_K_M`, 14.77B params) | `>= 16 GB` RAM (`-m 16G`) | `OO-PERSISTENCE` (32 MiB GPT) | | |
| ### Verify Downloads (`SHA256SUMS`) | |
| ```bash | |
| curl -LO https://huggingface.co/LLM-Baremetal/OO/resolve/main/SHA256SUMS | |
| sha256sum -c --ignore-missing SHA256SUMS | |
| ``` | |
| * `oo-live-usb.img`: 811,597,312 bytes (~774 MiB) — SHA-256: `7cfd5473df0cdf64b87569bfbcaf674d80237e20af2361624eb787ce4a6ce3ac` | |
| * `oo_live_usb_qwen3-14B.img`: 9,170,606,592 bytes (~8.54 GiB) — SHA-256: `ff9a6a96813916d298c8c9d175d51026dd57f6821b7c32d62d35668b13ed9b1d` | |
| --- | |
| ## ⚡ Quick Start | |
| ### 1. Disable UEFI Secure Boot (Physical Hardware) | |
| `EFI/BOOT/BOOTX64.EFI` is currently unsigned. Before booting on physical `x86_64` UEFI hardware, enter your BIOS/UEFI firmware setup and **disable UEFI Secure Boot**. | |
| ### 2. Flash to a USB Drive | |
| **Linux / macOS:** | |
| ```bash | |
| # Llama 3.2 1B image: | |
| curl -LO https://huggingface.co/LLM-Baremetal/OO/resolve/main/oo-live-usb.img | |
| sudo dd if=oo-live-usb.img of=/dev/sdX bs=4M status=progress && sync | |
| # Or Qwen3-14B image: | |
| curl -LO https://huggingface.co/LLM-Baremetal/OO/resolve/main/oo_live_usb_qwen3-14B.img | |
| sudo dd if=oo_live_usb_qwen3-14B.img of=/dev/sdX bs=4M status=progress && sync | |
| ``` | |
| **Windows:** Flash either `.img` using **Rufus** or **balenaEtcher**. | |
| **HuggingFace CLI:** | |
| ```bash | |
| hf download LLM-Baremetal/OO oo-live-usb.img --local-dir . | |
| # or: | |
| hf download LLM-Baremetal/OO oo_live_usb_qwen3-14B.img --local-dir . | |
| ``` | |
| ### 3. Boot in QEMU / OVMF (Use `-machine q35` for Real Post-EBS Storage Persistence) | |
| > Always pass `-machine q35` with `qemu-xhci` / `usb-storage` (or AHCI/NVMe). Legacy i440fx IDE has no post-EBS driver and falls back to `VOLATILE_SOMA_RAM` (zero disk writes). | |
| **Llama 3.2 1B (`oo-live-usb.img`):** | |
| ```bash | |
| qemu-system-x86_64 \ | |
| -machine q35 -enable-kvm -cpu host -smp 4 -m 4G \ | |
| -bios /usr/share/ovmf/OVMF.fd \ | |
| -device qemu-xhci,id=xhci0 \ | |
| -drive id=usb0,file=oo-live-usb.img,format=raw,if=none \ | |
| -device usb-storage,bus=xhci0.0,drive=usb0 \ | |
| -netdev user,id=net0 \ | |
| -device e1000e,netdev=net0 \ | |
| -serial stdio | |
| ``` | |
| **Qwen3-14B (`oo_live_usb_qwen3-14B.img`):** | |
| ```bash | |
| qemu-system-x86_64 \ | |
| -machine q35 -enable-kvm -cpu host -smp 4 -m 16G \ | |
| -bios /usr/share/ovmf/OVMF.fd \ | |
| -device qemu-xhci,id=xhci0 \ | |
| -drive id=usb0,file=oo_live_usb_qwen3-14B.img,format=raw,if=none \ | |
| -device usb-storage,bus=xhci0.0,drive=usb0 \ | |
| -netdev user,id=net0 \ | |
| -device e1000e,netdev=net0 \ | |
| -serial stdio | |
| ``` | |
| --- | |
| ## 🧬 Architecture Highlights | |
| - **Bare-Metal UEFI `x86_64` Kernel:** Clean `ExitBootServices()` transition into Ring-0 SMP (LAPIC timer, INIT-SIPI-SIPI multi-core bring-up, 4-level paging, PMM/VMM, ACPI poweroff/reboot). CPU 0 runs somatic control, storage, UI, and networking while CPU 1 + worker APs execute neural inference. (Single-core `-smp 1` also degrades gracefully to desktop & safe telemetry.) | |
| - **Real Post-EBS Drivers (Zero Mocks):** | |
| - **Storage:** AHCI SATA, NVMe PCIe, and xHCI USB Mass Storage (read/write to `OO-PERSISTENCE` GPT partition with CRC32-verified somatic checkpoints and `OO-QWEN3` raw partition streaming). | |
| - **Networking & Cryptography:** Intel I219-LM / e1000e / e1000 Gigabit PCIe drivers, freestanding Ethernet/ARP/IPv4/ICMP/UDP/DHCP/DNS/TCP stack, and **BearSSL TLS 1.2** (`0x0303`) with RDRAND entropy, CMOS RTC clock validation, and X.509 anchor verification. (Outbound boot probes are disabled by default; network calls are user-initiated via `web`, `ping`, `dns`, `https`.) | |
| - **Sovereign Desktop (`OO-DESKTOP-NEXT`):** Freestanding Duktape 2.7.0 ES5 + TypeScript window/chat UI over direct GOP framebuffer (`XRGB8888`/`BGRX8888`), defaulting to `QWERTY` with one-click/command switching (`keymap azerty` / `keymap qwerty`). | |
| - **Real Bare-Metal LLM Inference:** Pure freestanding C inference (no CUDA/llama.cpp/POSIX deps) supporting AVX2+FMA with clean scalar fallback on SSE2-only CPUs (`-cpu qemu64`), INT8 KV cache, and Cryo-KV prefix reuse. | |
| - **Physical RAM Accounting Example (16 GiB Host):** e.g., `14,228 MiB` usable + `1,118 MiB` firmware/MMIO reserved = `15,346 MiB` reported E820 physical address space. | |
| --- | |
| ## 🇫🇷 Résumé Rapide (Français) | |
| - **Images disponibles :** `oo-live-usb.img` (Meta Llama 3.2 1B Instruct, recommandé `>= 4 Go` RAM) et `oo_live_usb_qwen3-14B.img` (Qwen3-14B `Q4_K_M`, recommandé `>= 16 Go` RAM). | |
| - **Secure Boot :** `EFI/BOOT/BOOTX64.EFI` n'est pas signé — **désactivez UEFI Secure Boot** dans le BIOS avant de démarrer sur PC physique. | |
| - **Clavier :** `QWERTY` par défaut (basculable à tout moment via `keymap azerty` ou clic sur le badge en haut à droite). | |
| - **QEMU :** Utilisez toujours `-machine q35` avec `qemu-xhci` / `usb-storage` (ou AHCI/NVMe) pour activer la persistance réelle sur la partition `OO-PERSISTENCE`. | |
| --- | |
| ## ⚖️ Licenses & Third-Party Notices | |
| - **Operating Organism (`BOOTX64.EFI`, kernel, drivers, network/TLS integration, OPI, OO-DESKTOP-NEXT):** Proprietary — All Rights Reserved © Djiby Diop. | |
| - **Meta Llama 3.2 1B Instruct (`llama3_1b_instruct_q40.bin` in `oo-live-usb.img`):** Built with Meta Llama 3.2 (Meta Llama 3.2 Community License Agreement). | |
| - **Qwen3-14B (`OO-QWEN3` in `oo_live_usb_qwen3-14B.img`):** Licensed under Apache License 2.0 (Alibaba Qwen Team). | |
| - **Intel Wireless 8260 Firmware (`iwlwifi-8000C-36.ucode`):** Copyright © Intel Corporation (redistributable Intel Linux Firmware license). | |
| - **Duktape 2.7.0 / BearSSL:** MIT License. | |