base on Lightweight, Linux-compatible kernel, written in Rust to leverage the safety of the typesystem. Aiming to remove as much legacy as possible while supporting most usecases <p align="center"> <picture> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/maestro-os/maestro-lnf/master/logo-light.svg"> <img src="https://raw.githubusercontent.com/maestro-os/maestro-lnf/master/logo.svg" alt="logo" width="50%" /> </picture> </p> [![AGPL-3.0 license](https://img.shields.io/badge/license-AGPL--3.0-blue.svg?style=for-the-badge&logo=book)](./COPYING) ![Version](https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fmaestro-os%2Fmaestro%2Fmaster%2Fkernel%2FCargo.toml&query=%24.package.version&style=for-the-badge&label=version) ![Rust toolchain](https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fmaestro-os%2Fmaestro%2Fmaster%2Frust-toolchain.toml&query=%24.toolchain.channel&style=for-the-badge&logo=rust&label=rust%20toolchain&color=%23444) ![Continuous integration](https://img.shields.io/github/actions/workflow/status/maestro-os/maestro/check.yml?style=for-the-badge&logo=github) ![Stars](https://img.shields.io/github/stars/maestro-os/maestro?style=for-the-badge&color=yellow) [![Discord](https://img.shields.io/discord/971452040821760080?style=for-the-badge&logo=discord&color=%235865f2)](https://discord.gg/4JMBN3YPAk) # About Maestro is a lightweight Unix-like kernel written in Rust. The goal is to provide a lightweight operating system able to use the safety features of the Rust language to be reliable. > This project is still in early stage development, thus it is highly unstable and misses a lot of features. **Do not use it in production!** To stay updated with the project, follow the [blog](https://blog.lenot.re)! <p align="center"> <img src="https://blog.lenot.re/assets/article/neofetch.png" alt="neofetch" width="100%" /> </p> [Neofetch](https://github.com/dylanaraps/neofetch) and bash running on the OS. # Features CPU architectures support | Architecture | Status | |--------------|--------| | x86_64 | ✅ | | x86 | ✅ | | AArch64 | 📅 | > - ✅ **Supported** > - 📅 **Planned** (not currently supported) The following features are currently implemented (non-exhaustive): - Terminal - [VGA text mode](https://en.wikipedia.org/wiki/VGA_text_mode) - [PS/2](https://en.wikipedia.org/wiki/PS/2_port) keyboard (includes forward compatibility with USB keyboards) - Partial support of [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code) - Memory management - [Buddy allocator](https://en.wikipedia.org/wiki/Buddy_memory_allocation) - Internal memory allocator, with similarities with **dlmalloc**'s implementation - Per-process virtual memory - Processes and [scheduler](https://en.wikipedia.org/wiki/Scheduling_(computing)) - Symmetric MultiProcessing (SMP) - POSIX signals - [PCI](https://en.wikipedia.org/wiki/Peripheral_Component_Interconnect) devices enumeration - Unix files - VFS/Mountpoints - [IDE/PATA](https://en.wikipedia.org/wiki/Parallel_ATA) - Page cache - Filesystem ([ext2](https://en.wikipedia.org/wiki/Extended_file_system) only for now) - Disk partitions ([MBR](https://en.wikipedia.org/wiki/Master_boot_record) and [GPT](https://en.wikipedia.org/wiki/GUID_Partition_Table)) - Virtual filesystems (`/tmp` and `/proc`) - initramfs - Unix pipes and sockets - Device files - Time - [PIT](https://en.wikipedia.org/wiki/Programmable_interval_timer) - [RTC](https://en.wikipedia.org/wiki/Real-time_clock) - APIC Timer - [HPET](https://en.wikipedia.org/wiki/High_Precision_Event_Timer) - Linux's system calls (roughly 30% are currently implemented) - Kernel modules - [ELF](https://en.wikipedia.org/wiki/Executable_and_Linkable_Format) programs # Quickstart This repository is not a full operating system in itself but only the kernel. You can either: - Use the [installer](https://github.com/maestro-os/maestro-install) to build a full operating system from an ISO file - Build the OS by hand. For this, you can check the kernel's book The OS can then be run by a virtual machine such a **QEMU** or **VirtualBox**, or on a physical machine. ## Build To build and/or run the OS, `cd` into the kernel's crate: ```sh cd kernel/ ``` Then follow the instructions in [README.md](kernel/README.md) ## Documentation The kernel's book contains general information on how to use the kernel. > `mdbook` and `mdbook-mermaid` are required: > > ```sh > cargo install mdbook mdbook-mermaid > ``` Build the book with: ```sh mdbook-mermaid install doc/ mdbook build doc/ ``` Then, it can be accessed at `doc/book/index.html`. ", Assign "at most 3 tags" to the expected json: {"id":"6651","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"