https://github.com/dinoslice/groveos
A simply, hobby OS written from scratch using Rust.
https://github.com/dinoslice/groveos
kernel operating-system os osdev
Last synced: 6 months ago
JSON representation
A simply, hobby OS written from scratch using Rust.
- Host: GitHub
- URL: https://github.com/dinoslice/groveos
- Owner: dinoslice
- Created: 2025-05-15T21:32:57.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-28T02:17:43.000Z (6 months ago)
- Last Synced: 2025-09-28T02:21:21.732Z (6 months ago)
- Topics: kernel, operating-system, os, osdev
- Language: Rust
- Homepage:
- Size: 1.48 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GroveOS
**GroveOS** is an open-source, hobby Operating System built from the ground up in rust for fun
## What is GroveOS?
GroveOS is a small, modular kernel and operating system written in Rust. It's built with a focus on:
- Clean architecture
- Extensibility through dynamically loaded modules
- Full control over low-level memory and system features
This project is not intended to be production-ready. It's a playground for experimentation with low-level system development!
## Features (Planned)
While GroveOS is still in early development, here's the planned roadmap:
- [ ] Full Virtual Memory Management System
- [ ] Modular design with dynamically loaded modules
- [ ] Custom heap implementation
- [ ] Filesystem operations
- [ ] User programs
- [ ] Built-in shell
- [ ] Custom `libc` implementation
## Current Status
GroveOS is in **early development**.
However, the `main` branch mostly has working code that:
- Builds without errors
- Will boot successfully in QEMU (but does pretty much nothing as of now)
## How to Build
### Prerequisites
- Rust (with nightly toolchain)
- QEMU
### Build the Project
```bash
git clone https://github.com/MSKatKing/GroveOS.git
cd groveos
cargo build-os # Builds the project and outputs the result in ./esp. Image file support coming soon...
cargo run-os # Builds and runs the project with QEMU
```
## Sources
Most, if not all, of the documentation and information used to create this project was found on [the OSDev wiki](https://wiki.osdev.org).
Huge shoutout to the wonderful contributors to that project! This project truly would not exist without them.
## How to Contribute
Coming soon...
For now, if you want to suggest a feature be added just create an issue and describe your idea there!