Raspberry Pi

​

Prerequisites

Make sure you have the following before installation:

• Device: Raspberry Pi 4 or 5 (8GB RAM or more recommended)
• OS: 64-bit Raspberry Pi OS or Debian-based 64-bit Linux distro
• Storage: At least 16GB free
• Network: Internet access

​

1. Update and Upgrade the System

Ensure your system is up to date before installing anything:

sudo apt update && sudo apt upgrade -y

​

2. Clone the Repository

git clone https://github.com/OpenmindAGI/OM1.git
cd OM1
git submodule update --init

​

3. Install Dependencies

3.1 Install the Rust-based Python package manager uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

3.2 Install PortAudio:

sudo apt-get install portaudio19-dev

​

4. Set Configuration Variables

Add your OpenMind API key to the configuration file:

1. Locate the config file at /config/spot.json5
2. Replace the placeholder with your OpenMind API key:

{
  ...
  "api_key": "om1_live_e4252f1cf005af..."
  ...
}

You can obtain a free API key at: https://portal.openmind.org/
Note: Using the placeholder key openmind-free will result in errors.

​

5. Run the Spot Agent

uv run src/run.py spot

​

6. Monitor with WebSim

Visit the following URL in your browser to see real-time logs, input, and output:

http://localhost:8000

For additional debug information, you can run:

uv run src/run.py spot --debug

​

Done

You’re now running OM1 on your Raspberry Pi. Explore its capabilities and refer to the OM1 GitHub repository for advanced settings and next steps:

https://github.com/OpenmindAGI/OM1

​

Note:

This is a general guide for getting OM1 started on Raspberry Pi. Depending on your specific robot’s firmware, OS version, or configuration, you may need additional modifications or pre-requirements. For details on supported setups, please visit: docs.openmind.org and refer to the Interfacing with New Robot Hardware section in https://github.com/OpenmindAGI/OM1