You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
94 lines
3.2 KiB
94 lines
3.2 KiB
---
|
|
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
|
|
```
|