Antipode

Open source drop-in replacement for Apple HomePod.

Antipode's core philosophy is that you should be able to control your home as if you're in 2026.

Right now we're using OpenAI Realtime 2 but will expand to compatibility with other providers including open source ones. The goal is to provide a world class experience for controlling your home that goes beyond just voice control.

We're starting with a simple CLI server that you can run on your machine and is able to hook into a Home Assistant resource.

In the future we will expand it to:

• fully abstract Google Home, Alexa, Apple Home
• shouldn't require anything pre-installed except an existing Apple Home / Alexa / Google Home setup
• easy to use GUI (most likely Electron or Tauri) for non-technical install
• satellite options to extend it via smaller devices all around your house that focus on processing audiovisual information and report back to the server
• image recognition to contextually understand your situation
• recommended hardware list to mix and match for an out-of-the-box experience

This is an alpha build.

Getting started

You'll need an OpenAI API key, a Home Assistant URL, and a Home Assistant token.

pnpm install
pnpm dev setup     # guided config wizard (or use env vars below)
pnpm dev doctor    # verify everything works
pnpm dev           # start the assistant

Microphone input needs sox (brew install sox on macOS).

Configuration

Run pnpm dev setup, or set environment variables (env always overrides the config file):

OPENAI_API_KEY=...
HOME_ASSISTANT_URL=http://homeassistant.local:8123
HOME_ASSISTANT_TOKEN=...

Commands

listen            start continuous wake mode (mic, stays open across turns)
stop              end the current session / wake mode
wake <request>    one-shot text request
history [n]       show the last n transcript entries
cost              estimated OpenAI usage + cost this session
status            show runtime state
doctor            run diagnostics
quit              exit

In wake mode, plain text typed at the prompt is sent straight to the assistant.

How it works

• Home Assistant is the single source of truth for devices and rooms; it mirrors to Apple Home / HomeKit, so Antipode never fights other systems.
• The assistant can control devices, report state, list rooms, move devices between rooms, re-sync the HomeKit bridge, and set timers.
• Smart entity search matches names, ids, aliases, and rooms so a device named one thing in Apple Home and another in Home Assistant can still be found.

Development

pnpm typecheck
pnpm test          # unit + HA integration (no network)
pnpm test:e2e      # real OpenAI Realtime E2E (needs OPENAI_API_KEY)

License

MIT