AlopexOS

AlopexOS is an advanced, high-performance, proprietary operating system engineered from the ground up for absolute technical excellence, determinism, and low-level control. Designed to bridge modern high-level abstractions with zero-cost bare-metal execution, AlopexOS incorporates custom subsystems—such as the high-integrity AbtrFS storage filesystem—to deliver maximum reliability and performance.

---

Table of Contents

1. Project Documentation & Governance
2. What is AlopexOS?
3. Prerequisites & Dependencies
4. Compilation & Build Instructions
5. Running via QEMU
6. Installation Instructions
7. Contributors

---

1. Project Documentation & Governance

To maintain absolute structural clarity, legal control, and architectural purity, the project documentation is partitioned into distinct, authoritative files:

• AlopexOSCxxPhilosophy.md: Dictates the strict C++ programming standards, architectural core tenets, memory management paradigms, and syntax constraints required across the entire codebase.
• LICENSE.md: Establishes the legal ownership, proprietary licensing tiers (consumer free-use vs. commercial enterprise/government mandates), anti-piracy restrictions, and intellectual property jurisdiction under Project Director Fenn Vinter.
• Contributors.md: Formally acknowledges and credits developers and contributors who support the development and expansion of the AlopexOS ecosystem.

---

2. What is AlopexOS?

AlopexOS is a closed-source, proprietary operating system project built on strict architectural constraints. It rejects conventional bloat and embraces modern, zero-cost C++ principles to ensure supreme execution speed, hardware predictability, and type safety down to the bare metal.

• Licensing Model: Free for individual end-user consumers for personal applications, while commercial entities, corporations, and government organizations are legally required to purchase a commercial enterprise license. Refer to LICENSE.md for full legal terms.
• IP Protection: All code, documentation, and architecture are exclusively owned and governed by Project Director Fenn Vinter / AurenFox.Studio.

---

3. Prerequisites & Dependencies

To build and run AlopexOS from source, your development environment must include the following native tools and dependencies:

• Compiler Toolchain: A modern Clang environment enforcing strict C++ standards.
• Build System: CMake (compatible with out-of-source builds).
• Virtualization & Emulation: QEMU (qemu-system-x86_64) and qemu-img for creating disk and NVMe backing images.
• Execution Environment: Python 3 (required to execute the cross-platform scripts/build_and_run.py automation script).

---

4. Compilation & Build Instructions

AlopexOS utilizes a automated Python build script (scripts/build_and_run.py) to handle directory clean-up, CMake configuration, compilation, image validation, and QEMU execution across platforms.

1. Open a terminal in the root directory of the project.
2. Execute the build script:

   python3 scripts/build_and_run.py