Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omi.me/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Store audio files from your Omi device in Google Cloud Storage (GCS). This guide walks you through creating a bucket, setting up credentials, and connecting it to the Audio Streaming feature.
You’ll need an active Google Cloud Platform account. If you don’t have one, create one here.

​
Setup

Create a Storage Bucket

  1. Go to the GCS console
  2. Click Create Bucket
  3. Configure the bucket:
SettingRecommended Value
NameSomething unique, e.g. omi-audio-files
LocationMulti-region for reliability, or single region for lower cost
Storage classStandard (for frequently accessed files)
Public accessOff (keep audio private)
Access controlUniform
  1. Click Create

Create a Service Account

  1. Go to IAM & Admin → Service Accounts in the GCP console
  2. Click Create Service Account
  3. Set the name (e.g. omi-audio-uploader)
  4. Grant the Storage Object User role
  5. Click Done

Generate a JSON Key

  1. Click on the service account you just created
  2. Go to the Keys tab
  3. Click Add Key → Create new key → JSON
  4. The key file downloads automatically
Keep this key file secure. It grants access to your storage bucket.

Base64 Encode the Key

Convert the key to Base64 for use as an environment variable:
base64 -i your-key-file.json
Copy the output — this is your GOOGLE_APPLICATION_CREDENTIALS_JSON value.

Note Your Bucket Name

Go back to the GCS console and copy your bucket name from the list. This is your GCS_BUCKET_NAME value.

​
Environment Variables

You’ll need these two values when deploying the audio streaming service:
VariableDescription
GOOGLE_APPLICATION_CREDENTIALS_JSONBase64-encoded service account key
GCS_BUCKET_NAMEYour storage bucket name

​
Next Steps

Audio Streaming

Stream real-time audio from your device to cloud storage

Build Apps

Create apps that use audio data