---
title: "Getting Started"
description: "Preparing your machine"
---

## Prerequisites

To run 01OS on your computer, you will need to install a few essential packages.

<Card
  title="Install Poetry"
  icon="link"
  href="https://python-poetry.org/docs/#installing-with-the-official-installer"
>
  To install poetry, follow the official guide here.
</Card>

### MacOS

```bash
brew install portaudio ffmpeg cmake
```

### Ubuntu

<Note>Wayland not supported, only Ubuntu 20.04 and below</Note>

```bash
sudo apt-get install portaudio19-dev ffmpeg cmake
```

### Windows

- [Git for Windows](https://git-scm.com/download/win).
- [Chocolatey](https://chocolatey.org/install#individual) to install the required packages.
- [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools):
  - Choose [**Download Build Tools**](https://visualstudio.microsoft.com/visual-cpp-build-tools/).
  - Run the downloaded file **vs_BuildTools.exe**.
  - In the installer, select **Workloads** > **Desktop & Mobile** > **Desktop Development with C++**.

With these installed, you can run the following commands in a **PowerShell terminal as an administrator**:

```powershell
# Install the required packages
choco install -y ffmpeg
```