OO / README.md
djibydiop's picture
Fix F-02..F-18: split .bss + NX_COMPAT EFI (2.8MB), unique GPT GUIDs, compact 1B image, QWERTY default, SMP1/low-RAM safe mode, opt-in net probes, prompt-injection & abort guards, and updated README/SHA256SUMS
355e2cf verified
|
Raw History Blame Contribute Delete
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.