Attention

PotatoOS is currently in early alpha and is not available for download. Features and APIs documented here are subject to change.

PotatoOS Documentation

Welcome to the official documentation for PotatoOS, a “parasite” Operating System.

PotatoOS offers a complete, modern computing environment that runs as an application on your existing host system (Windows, macOS, Linux, etc.). It’s built on the Godot Engine and powered entirely by the STARCH programming language.

Start Here

Whether you want to use the operating system or develop applications for it, here are the best places to begin:

Users:

Use and configure PotatoOS. Learn how to install the system, navigate the file structure, and use the built-in Mash shell.

• Installation Guide

• Basic Navigation

• Mash Shell Overview

Developers:

Build applications using STARCH. Dive into the core language syntax and learn how to leverage PotatoOS’s native APIs.

• STARCH Language Reference

• The GUI Module

• Your First Program

Explore the System

Get an overview of the system’s unique design and core components:

• Introduction: What is a “Parasite OS” and why was it built?

• Features: The key capabilities and unique advantages of PotatoOS.

• Architecture: A deep dive into the Godot, STARCH, and Potatofs layers.