Small, modular hobby kernel written in Rust — designed to be easy to extend and learn from.

Please read current_spec.txt to understand what is going on.

You can install all prerequisites through the setup-dev scripts for both Windows, and Linux / Unix. Just run the script and it will install everything for you. If something doesnt work. Please setup a GitHub Issue so that I can fix it as fast as possible.

You can build the project through running

make build

Which will build everything and output a .bin and .iso file within: build/os-x86_64.iso and build/kernel-x86_64.bin

To run the test suite (which isnt really used currently) you can run:

cargo test

Run the QEMU Emulator:

make run

Contributions are welcome! Please check out the CONTRIBUTING.md for details on the code of conduct, and the process for submitting pull requests.

This project is licensed under the MIT License – see the LICENSE file for details.

For questions, suggestions, or contributions, please open an issue in this repository.