Skip to main content

Overview

A pip-installable Python SDK for connecting to Omi wearable devices over Bluetooth, decoding Opus-encoded audio, and transcribing it in real time using Deepgram.

Bluetooth Connection

Connect to any Omi device

Opus Decoding

Decode Opus audio to PCM

Real-time Transcription

Deepgram-powered STT

Installation

Prerequisites

The SDK requires the Opus audio codec library:

Install the SDK


Quick Start

1

Set Up Your Environment

Get a free API key from Deepgram:
2

Find Your Omi Device

Scan for nearby Bluetooth devices:
Look for a device named “Omi” and copy its MAC address:
3

Write Your Code

4

Run the Example

The example will:
  • Connect to your Omi device via Bluetooth
  • Decode incoming Opus audio packets to PCM
  • Transcribe audio in real-time using Deepgram
  • Print transcriptions to the console

API Reference

Core Functions

Command Line Tools


Development

Local Development Setup


Troubleshooting

Make sure the Opus audio codec is installed on your system. See the Prerequisites section above for installation commands.
Go to System Preferences → Privacy & Security → Bluetooth and grant access to Terminal and Python.
The SDK requires Python 3.10 or higher. Check your version with python --version.
Make sure your Omi device is powered on and nearby. Try running omi-scan to verify it’s discoverable.
The SDK uses websockets>=11.0. Try upgrading: pip install --upgrade websockets

License

MIT License — built by the community.

SDK Overview

Compare all available SDKs

GitHub Source

View source code and contribute