circutrider21 / vinix

Vinix is an effort to write a modern, fast, and useful operating system in the V programming language

Vinix

Vinix is an effort to write a modern, fast, and useful operating system in the V programming language.

Join the Discord chat (#vinix-os channel).

Download the ISO

You can get a continuously updated ISO of Vinix here.

What is Vinix all about?

• Keeping the code as simple and easy to understand as possible, while not sacrificing performance and prioritising code correctness.
• Making a usable OS which can run on real hardware, not just on emulators or virtual machines.
• Targetting modern 64-bit architectures, CPU features, and multi-core computing.
• Maintaining good source-level compatibility with Linux to allow to easily port programs over.
• Exploring V capabilities in bare metal programming and improving the compiler in response to the uncommon needs of bare metal programming.
• Having fun.

Build instructions

OS-agnostic build prerequisites

The following is an OS-agnostic list of packages needed to build Vinix. Skip to a paragraph for your host OS if there is any.

GNU make, GNU patch, GNU tar, GNU gzip, GNU coreutils, git, mtools, meson, ninja, m4, texinfo, gcc/clang, nasm, python3, pip3, zic, wget, xorriso, and qemu to test it.

Build prerequisites for Ubuntu, Debian, and derivatives

sudo apt install build-essential nasm git mtools meson m4 texinfo python3 python3-pip manpages wget xorriso qemu-system-x86

Build prerequisites for Arch Linux and derivatives

sudo pacman -S base-devel nasm git mtools meson python python-pip tzdata wget xorriso qemu-arch-extra

Building Vinix on macOS

This build system does not officially support macOS. Run this in an x86_64 Linux VM or real hardware.

Installing xbstrap

It is necessary to fetch xbstrap from pip3:

sudo pip3 install xbstrap

Building the distro

To build the distro which includes the cross toolchain necessary to build kernel and ports, run:

make distro

This step will take a while.

Building the kernel and image

Simply run

make

To test

In Linux, if KVM is available, run with

make run-kvm

In macOS, if hvf is available, run with

make run-hvf

To run without any acceleration, run with

make run