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

## Overview

The 01 project is an open-source ecosystem for artificially intelligent devices. By combining code-interpreting language models ("interpreters") with speech recognition and voice synthesis, the 01's flagship operating system ("01") can power conversational, computer-operating AI devices similar to the Rabbit R1 or the Humane Pin.

Our goal is to become the "Linux" of this new space—open, modular, and free for personal or commercial use.

<Note>The current version of 01 is a developer preview.</Note>

## Components

The 01 consists of two main components:

### Server

The server runs on your computer and acts as the brain of the 01 system. It:

- Passes input to the interpreter
- Executes commands on your computer
- Returns responses

### Client

The client is responsible for capturing audio for controlling computers running the 01 server. It:

- Transmits audio to the server
- Plays back responses

# Prerequisites

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

#### What is Poetry?

Poetry is a tool for dependency management and packaging in Python. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you. We use Poetry to ensure that everyone running 01 has the same environment and dependencies.

<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>

### Operating Systems

#### MacOS

On MacOS, we use Homebrew (a package manager) to install the required dependencies. Run the following command in your terminal:

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

This command installs:

- [PortAudio](https://www.portaudio.com/): A cross-platform audio I/O library
- [FFmpeg](https://www.ffmpeg.org/): A complete, cross-platform solution for recording, converting, and streaming audio and video
- [CMake](https://cmake.org/): An open-source, cross-platform family of tools designed to build, test and package software

#### Ubuntu

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

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

This command installs:

- [PortAudio](https://www.portaudio.com/): A cross-platform audio I/O library
- [FFmpeg](https://www.ffmpeg.org/): A complete solution for recording, converting, and streaming audio and video
- [CMake](https://cmake.org/): An open-source, cross-platform family of tools designed to build, test and package software

#### 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
```
