## Community:
Join us in our [Discord](https://discord.gg/uD76Qweght), we're quite active and open for contributors!
## Getting Started
### **Requirements**
- [MinGW](https://www.mingw-w64.org/)
- [Clang](https://clang.llvm.org/)
- [NASM](https://nasm.us/)
- [NeBuild](https://github.com/ne-foss-org/nebuild)
- CoreUtils
- [Git](https://git-scm.com/)
- [Nectar](https://github.com/ne-foss-org/nectar)
### **Building & Running**
Please fork, and clone the repository. Then follow those steps:
```sh
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)
```
---
## Structure
- `src/kernel/` — Core kernel source (scheduling, memory, VFS, drivers)
- `src/boot/` — Bootloader, platform bring-up, and early system code
- `src/libDDK/` — Driver Development Kit (DDK) and sample drivers
- `src/libSystem/` — Userland system call interface and runtime
- `src/launch/` — NeKernel Launch System
- `src/libMsg/` — NeKernel OpenMSG framework
- `public/tools/` — CLI tools (mkfs, fsck, open, manual, etc.)
- `public/frameworks/` — Userland frameworks (CoreFoundation, DiskImage, etc.)
- `doc/` — Specifications, design docs, and diagrams
---
## Security
- **Vulnerability Disclosure:**
Please report security issues privately via email or GitHub Security Advisories.
---
## Documentation
- [Documentation](https://docs.src.nekernel.org/)
- [Specifications](doc/tex/)
---
## 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](https://github.com/ne-foss-org/nekernel/graphs/contributors)
---
## Citing
- Refer to [CITATION.cff](CITATION.cff)
---
## License
NeKernel is licensed under the [Apache-2.0 License](LICENSE).
---
## Figures:
#### Figure 1: The Microkernel Booting
© 2023-2026 Amlal El Mahrouss & Ne.org Authors. Licensed under the Apache 2.0 license.
