{"id":13503767,"url":"https://github.com/Andy-Python-Programmer/aero","last_synced_at":"2025-03-29T18:31:31.651Z","repository":{"id":38037091,"uuid":"346250541","full_name":"Andy-Python-Programmer/aero","owner":"Andy-Python-Programmer","description":"Aero is a new modern, experimental, UNIX-like operating system following the monolithic kernel design. Supporting modern PC features such as long mode, 5-level paging, and SMP (multicore), to name a few.","archived":false,"fork":false,"pushed_at":"2024-09-07T03:42:28.000Z","size":234648,"stargazers_count":1205,"open_issues_count":26,"forks_count":50,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-23T04:11:14.227Z","etag":null,"topics":["aero","hacktoberfest","operating-system","rust","uefi","unix"],"latest_commit_sha":null,"homepage":"https://aero.andypy.dev","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Andy-Python-Programmer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["Andy-Python-Programmer"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2021-03-10T06:05:50.000Z","updated_at":"2025-03-21T22:09:55.000Z","dependencies_parsed_at":"2023-10-16T03:10:55.576Z","dependency_job_id":"4d5cf11b-9717-4a51-abf1-282b60862d16","html_url":"https://github.com/Andy-Python-Programmer/aero","commit_stats":{"total_commits":1343,"total_committers":18,"mean_commits":74.61111111111111,"dds":0.1236038719285183,"last_synced_commit":"c5f81142d8996044730436349d3b005bbb0b9b9e"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andy-Python-Programmer%2Faero","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andy-Python-Programmer%2Faero/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andy-Python-Programmer%2Faero/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Andy-Python-Programmer%2Faero/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Andy-Python-Programmer","download_url":"https://codeload.github.com/Andy-Python-Programmer/aero/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246227027,"owners_count":20743872,"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":["aero","hacktoberfest","operating-system","rust","uefi","unix"],"created_at":"2024-07-31T23:00:44.900Z","updated_at":"2025-03-29T18:31:27.453Z","avatar_url":"https://github.com/Andy-Python-Programmer.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./misc/aero-logo.png\"\u003e\n\u003c/p\u003e\n\n# Aero\n\n**Aero** is a new modern, experimental, unix-like operating system written in Rust. \nAero follows the monolithic kernel design and it is inspired by the Linux Kernel. \nAero supports *modern* PC features such as Long Mode, 5-level paging, \nand SMP (multicore), to name a few.\n\n![workflow](https://github.com/Andy-Python-Programmer/aero/actions/workflows/build.yml/badge.svg)\n[![lines_of_code](https://img.shields.io/endpoint?url=https://andypythonappdevelop.npkn.net/f0d517/)](https://github.com/Andy-Python-Programmer/aero)\n[![discord](https://img.shields.io/discord/828564770063122432)](https://discord.gg/8gwhTTZwt8)\n\n**Is this a Linux distribution?**\nNo, Aero runs its own kernel that does *not* originate from Linux and does not share any source code or binaries with the Linux kernel.\n\n**Official Discord Server**: \u003chttps://discord.gg/8gwhTTZwt8\u003e\n\n# Screenshots\n\u003cimg src=\"misc/dwm-alacritty-glxgears.png\"\u003e\n\u003cp align=\"center\"\u003eRunning \u003ca href=\"https://dwm.suckless.org/\"\u003eDWM\u003c/a\u003e, \u003ca href=\"https://github.com/freedesktop/mesa-demos\"\u003emesa-demos\u003c/a\u003e and \u003ca href=\"https://github.com/alacritty/alacritty\"\u003eAlacritty\u003c/a\u003e in Aero!\u003c/p\u003e\n\n# Features\n- 64-bit higher half kernel\n- 4/5 level paging\n- Preemptive per-cpu scheduler\n- Modern UEFI bootloader\n- ACPI support (ioapic, lapic)\n- Symmetric Multiprocessing (SMP)\n- On-demand paging\n\n# Goals\n\n* Creating a modern, safe, beautiful and fast operating system.\n* Targeting modern 64-bit architectures and CPU features.\n* Good source-level compatibility with Linux so we can port programs over easily.\n* Making a usable OS which can run on real hardware, not just on emulators or virtual machines.\n\n# How to Build and Run Aero\n\nPlease make sure you have a Linux host system before building \nAero. If you are using windows, use WSL 2.\n\n## Dependencies\n\nBefore building Aero, you need the following things installed:\n- `rust` (should be the **latest nightly**)\n- `nasm`\n- `qemu` (optional: required if you want to run it in the Qemu emulator)\n- `make`\n\n## Hardware\n\nThe following are *not* requirements but are *recommendations*:\n- ~15GB of free disk space (this will vary depending on the amount of packages you want to build)\n- \\\u003e= 8GB RAM\n- \\\u003e= 2 cores\n- Internet access\n\nBeefier machines will lead to much faster builds!\n\n## Getting the source code\n\nThe very first step to work on Aero is to clone the repository:\n```shell\n$ git clone https://github.com/Andy-Python-Programmer/aero\n$ cd aero\n```\n\n## Building Aero\n\n```shell\nmake distro-image\nmake qemu\n\n# To build documentation run the following command. The documentation will be outputed\n# to the `target/doc` directory.\n#\n# Optionally you can pass `open=yes` to open the documentation in the default browser.\nmake doc open=yes\n```\n\n# Contributing\n\nContributions are absolutely, positively welcome and encouraged! Check out [CONTRIBUTING.md](CONTRIBUTING.md) for the contributing guidelines for aero.\n\n# License\n\n\u003cimg src=\"misc/gpl.png\" align=\"right\" width=200x\u003e\n\nAero is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version. See the [LICENSE](LICENSE) file for license rights and limitations.\n","funding_links":["https://github.com/sponsors/Andy-Python-Programmer"],"categories":["Applications","Rust","Active","Projects"],"sub_categories":["Operating systems","Operating Systems"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAndy-Python-Programmer%2Faero","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAndy-Python-Programmer%2Faero","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAndy-Python-Programmer%2Faero/lists"}