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
metadata
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)

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:

# 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:

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):

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):

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.