🍯 The NeKernel

About:

The base system designed for scalability and portability, hybrid and written in modern C++ for backend systems.

Getting Started:

Requirements:

• MinGW
• Clang
• NASM
• NeBuild
• CoreUtils
• Git
• Nectar

Building & Running

Please fork, and clone the repository. Then follow those steps:

git clone -j8 https://github.com/ne-foss-org/nekernel.git
cd nekernel
./scripts/setup_x64_project.sh
./scripts/modules_ahci_x64.sh
./scripts/debug_ahci_x64.sh   # For debug generic AHCI target (QEMU, UDF)

---

Community:

Join our Discord, we're quite active and open for contributors!

Structure

• src/kernel/ — Hybrid Kernel sources (SwapKit, KernelKit, SMP, Memory, FileMgr)
• src/boot/ — Bootloader and Boot modules sources (BootKit, modules, EFI/NeBoot bring-up)
• src/libDDK/ — Driver Development Kit (DDK)
• src/libSystem/ — Userland system call interface and runtime
• src/launch/ — NeKernel Launch System.
• src/libMsg/ — NeKernel OpenMSG framework.
• public/tools/ — CLI tools (mkfs, chk, open, manual, etc.)
• public/frameworks/ — Userland frameworks (CoreFoundation, DiskImage, etc.)
• doc/ — Specifications, design docs, requirements, and diagrams.

---

Design Rationale:

The sources are designed to be modular and gracefully error when needed.

Modern C/C++ is also used to implement the system, alongside assembly stubs in the HAL.

---

Security

• Vulnerability Disclosure:
  Please report security issues privately via email or GitHub Security Advisories.

---

Documentation

• Documentation
• Specifications

---

Contributing

• Please run format.sh before committing (uses .clang-format).
• All contributions (code, docs, fuzzing, security) are welcome!

---

Authors & Credits

• Amlal El Mahrouss — Lead and Kernel Architect.
• Full contributor list

---

Citing

• Refer to CITATION.cff

---

License

NeKernel is licensed under the Apache-2.0 License.

---

Figures:

Figure 1: The Hybrid Kernel booting

_{© 2022-2026 Amlal El Mahrouss & Ne.app Authors. Licensed under the Apache 2.0 license.}