{"id":17524060,"url":"https://github.com/asterinas/asterinas","last_synced_at":"2025-03-06T04:32:15.940Z","repository":{"id":218484696,"uuid":"493375250","full_name":"asterinas/asterinas","owner":"asterinas","description":"Asterinas is a secure, fast, and general-purpose OS kernel, written in Rust and providing Linux-compatible ABI.","archived":false,"fork":false,"pushed_at":"2024-10-30T02:42:16.000Z","size":6727,"stargazers_count":2207,"open_issues_count":260,"forks_count":125,"subscribers_count":19,"default_branch":"main","last_synced_at":"2024-10-30T05:09:10.426Z","etag":null,"topics":["kernel","os","rust","tee"],"latest_commit_sha":null,"homepage":"https://asterinas.github.io/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asterinas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-MPL","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}},"created_at":"2022-05-17T18:48:52.000Z","updated_at":"2024-10-30T04:32:17.000Z","dependencies_parsed_at":"2024-04-28T04:11:54.185Z","dependency_job_id":"e7ce4bf8-127b-4277-8380-2cbc9c98ed34","html_url":"https://github.com/asterinas/asterinas","commit_stats":null,"previous_names":["asterinas/asterinas"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterinas%2Fasterinas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterinas%2Fasterinas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterinas%2Fasterinas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterinas%2Fasterinas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asterinas","download_url":"https://codeload.github.com/asterinas/asterinas/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242150723,"owners_count":20080003,"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":["kernel","os","rust","tee"],"created_at":"2024-10-20T14:01:45.769Z","updated_at":"2025-03-06T04:32:15.935Z","avatar_url":"https://github.com/asterinas.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"docs/src/images/logo_en.svg\" alt=\"asterinas-logo\" width=\"620\"\u003e\u003cbr\u003e\n    A secure, fast, and general-purpose OS kernel written in Rust and compatible with Linux\u003cbr/\u003e\n    \u003ca href=\"https://github.com/asterinas/asterinas/actions/workflows/test_osdk.yml\"\u003e\u003cimg src=\"https://github.com/asterinas/asterinas/actions/workflows/test_osdk.yml/badge.svg?event=push\" alt=\"Test OSDK\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/asterinas/asterinas/actions/workflows/test_asterinas.yml\"\u003e\u003cimg src=\"https://github.com/asterinas/asterinas/actions/workflows/test_asterinas.yml/badge.svg?event=push\" alt=\"Test Asterinas\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://asterinas.github.io/benchmark/\"\u003e\u003cimg src=\"https://github.com/asterinas/asterinas/actions/workflows/benchmark_asterinas.yml/badge.svg\" alt=\"Benchmark Asterinas\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\n    \u003cbr/\u003e\n\u003c/p\u003e\n\nEnglish | [中文版](README_CN.md) | [日本語](README_JP.md)\n\n## Introducing Asterinas\n\nAsterinas is a _secure_, _fast_, and _general-purpose_ OS kernel\nthat provides _Linux-compatible_ ABI.\nIt can serve as a seamless replacement for Linux\nwhile enhancing _memory safety_ and _developer friendliness_.\n\n* Asterinas prioritizes memory safety\nby employing Rust as its sole programming language\nand limiting the use of _unsafe Rust_\nto a clearly defined and minimal Trusted Computing Base (TCB).\nThis innovative approach,\nknown as [the framekernel architecture](https://asterinas.github.io/book/kernel/the-framekernel-architecture.html),\nestablishes Asterinas as a more secure and dependable kernel option.\n\n* Asterinas surpasses Linux in terms of developer friendliness.\nIt empowers kernel developers to\n(1) utilize the more productive Rust programming language,\n(2) leverage a purpose-built toolkit called [OSDK](https://asterinas.github.io/book/osdk/guide/index.html) to streamline their workflows,\nand (3) choose between releasing their kernel modules as open source\nor keeping them proprietary,\nthanks to the flexibility offered by [MPL](#License).\n\nWhile the journey towards a production-grade OS kernel is challenging,\nwe are steadfastly progressing towards this goal.\nOver the course of 2024,\nwe significantly enhanced Asterinas's maturity,\nas detailed in [our end-year report](https://asterinas.github.io/2025/01/20/asterinas-in-2024.html).\nIn 2025, our primary goal is to make Asterinas production-ready on x86-64 virtual machines\nand attract real users!\n\n## Getting Started\n\nGet yourself an x86-64 Linux machine with Docker installed.\nFollow the three simple steps below to get Asterinas up and running.\n\n1. Download the latest source code.\n\n```bash\ngit clone https://github.com/asterinas/asterinas\n```\n\n2. Run a Docker container as the development environment.\n\n```bash\ndocker run -it --privileged --network=host --device=/dev/kvm -v $(pwd)/asterinas:/root/asterinas asterinas/asterinas:0.11.3\n```\n\n3. Inside the container, go to the project folder to build and run Asterinas.\n\n```bash\nmake build\nmake run\n```\n\nIf everything goes well, Asterinas is now up and running inside a VM.\n\n## The Book\n\nSee [The Asterinas Book](https://asterinas.github.io/book/) to learn more about the project.\n\n## License\n\nAsterinas's source code and documentation primarily use the \n[Mozilla Public License (MPL), Version 2.0](https://github.com/asterinas/asterinas/blob/main/LICENSE-MPL).\nSelect components are under more permissive licenses,\ndetailed [here](https://github.com/asterinas/asterinas/blob/main/.licenserc.yaml). For the rationales behind the choice of MPL, see [here](https://asterinas.github.io/book/index.html#licensing).\n","funding_links":[],"categories":["HarmonyOS","Rust","Applications"],"sub_categories":["Windows Manager","Operating systems"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasterinas%2Fasterinas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasterinas%2Fasterinas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasterinas%2Fasterinas/lists"}