{"id":19272287,"url":"https://github.com/sdslabs/rusticos","last_synced_at":"2025-04-21T22:31:20.614Z","repository":{"id":40272462,"uuid":"262772068","full_name":"sdslabs/rusticos","owner":"sdslabs","description":"Rustic OS written completely in Rust","archived":false,"fork":false,"pushed_at":"2022-09-27T18:03:24.000Z","size":64551,"stargazers_count":6,"open_issues_count":3,"forks_count":1,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-05-28T00:27:09.276Z","etag":null,"topics":["cargo","kernel","makefile","operating-system","rust"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sdslabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-10T11:28:16.000Z","updated_at":"2023-08-23T04:39:56.000Z","dependencies_parsed_at":"2023-01-17T18:45:50.777Z","dependency_job_id":null,"html_url":"https://github.com/sdslabs/rusticos","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Frusticos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Frusticos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Frusticos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Frusticos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdslabs","download_url":"https://codeload.github.com/sdslabs/rusticos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223881292,"owners_count":17219262,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cargo","kernel","makefile","operating-system","rust"],"created_at":"2024-11-09T20:36:11.517Z","updated_at":"2024-11-09T20:36:12.030Z","avatar_url":"https://github.com/sdslabs.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rustic OS\n\u003e Rustic OS written completely in Rust\n\n[![Kernel CI](https://github.com/sdslabs/rusticos/actions/workflows/kernel.yaml/badge.svg)](https://github.com/sdslabs/rusticos/actions/workflows/kernel.yaml)\n\nRustic OS is our attempt at developing a modular kernel written completely in Rust with an attempt to make it as usable for daily driver needs as possible.\n\n## Contents\n\n* [Dependencies](#dependencies)\n* [Development](#development)\n* [Contributing](#contributing)\n* [Contact](#contact)\n\n## Dependencies\n\nThe dependencies required for compiling and running Rustic OS are [Rust](https://www.rust-lang.org/) and [QEMU](https://www.qemu.org/). Their installation guides are linked below:\n\n* [Rust](https://www.rust-lang.org/tools/install)\n* [QEMU](https://www.qemu.org/download/)\n\n## Development\n\nOpen your favourite terminal and perform the following tasks:-\n\n1. Clone this repository.\n\n    ```bash\n    $ git clone https://github.com/sdslabs/rusticos\n    ```\n\n1. Go inside the cloned directory and list available *makefile* commands.\n\n    ```bash\n    $ cd rusticos \u0026\u0026 make help\n\n    RusticOS, Lightweight OS implementation in Rust\n\n    install        Install toolchain dependencies\n    fmt            Format codebase using cargo fmt\n    kernel_build   Build kernel image\n    kernel_test    Run kernel tests\n    kernel_run     Attach QEMU and run kernel\n\n    Do check out the code at https://github.com/sdslabs/rusticos\n    ```\n\n1. Run `make install` to install the necessary toolchain dependencies and change Rust version to nightly-2021-12-07.\n\n    \u003e This is necessary to enable some of the dependency crates\n\n    ```bash\n    $ make install\n    ```\n\n1. Compile the kernel crate and build the kernel binary and link with the bootloader.\n\n    ```bash\n    $ make kernel_build\n    ```\n\n1. Attach QEMU as the runner and boot up the kernel.\n\n    ```bash\n    $ make kernel_run\n    ```\n\n## Contributing\n\nIf you'd like to contribute to this project, refer to the [contributing documentation](./CONTRIBUTING.md).\n\n## Contact\n\nIf you have a query regarding the product or just want to say hello then feel free to visit\n[chat.sdslabs.co](http://chat.sdslabs.co/) or drop a mail at [contact@sdslabs.co.in](mailto:contact@sdslabs.co.in)\n\nCreated with :heart: by [SDSLabs](https://github.com/sdslabs)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdslabs%2Frusticos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdslabs%2Frusticos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdslabs%2Frusticos/lists"}