Skip to content

others-git/bifrost

Repository files navigation

Bifrost

Bifrost

A self-hosted smart-home hub — control your devices from one web UI, a REST API, and voice.

Latest release CI License Docs Container image Unraid Community Apps


Bifrost unifies your smart-home devices behind a single, fast, self-hosted control surface — a web dashboard, a REST API, an embedded assistant (MCP) server, and natural-language voice. It's built around reliability: every device connection is owned by a state machine with reconnection, backoff, and live push to the browser, and a read that can't reach a device falls back to cached state rather than failing.

Documentation

📖 Full docs: https://others-git.github.io/bifrost/

  • Overview — what Bifrost is and how it's built
  • Setup guide — install, configuration, first-run, voice, the wall tablet
  • Providers — Hue, Govee, LIFX, Onkyo/Integra, Sonos, Home Assistant
  • Public API — the Bearer-key /api/v1 REST surface
  • MCP server — the embedded assistant tool catalogue

Quick start (Docker)

mkdir bifrost && cd bifrost
curl -fsSLO https://raw.githubusercontent.com/others-git/bifrost/main/docker-compose.yml
test -f .env || echo "BIFROST_SECRET=$(openssl rand -hex 32)" > .env
docker compose up -d

Then open http://<host>:3000. Keep BIFROST_SECRET identical across upgrades — it encrypts your provider credentials at rest. See the install guide for bare-binary builds and configuration.

On Unraid? Bifrost is in Community Applications — search Bifrost on the Apps tab and apply the template.

Companion repos

AI usage disclosure

Bifrost is built with heavy use of AI assistance — primarily Claude Code. AI contributed to code, tests, and documentation throughout. Every change is gated by the same CI as any other (cargo fmt, cargo clippy -D warnings, the full test suite, and the frontend build), and AI-assisted commits carry a Co-Authored-By: Claude trailer.

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors