Beacon Gateway

Always-on voice and messaging gateway for AI assistants

Website | Discord | GitHub

Overview

Beacon is a Rust daemon that connects AI assistants to voice and 13+ messaging platforms through a single gateway. It handles wake word detection, speech processing, multi-channel messaging, persona management, persistent memory, and tool execution -- all local-first with BYOK provider keys.

Quick start

1. Configure

# Interactive setup (recommended)
beacon setup

# Or manually: copy the template and add your API keys
cp .env.local.template .env.local

At minimum you need one AI provider key (ANTHROPIC_API_KEY or OPENAI_API_KEY).

2. Run

# Voice + messaging
beacon --foreground -v

# Messaging only (headless)
beacon --disable-voice

The gateway starts on http://localhost:18789 and connects to any configured channels.

3. Diagnostics

beacon doctor    # Health check
beacon status    # Service status

Development

cargo build
cargo test
cargo clippy
cargo run -- --foreground -v

Ecosystem

• Omni CLI -- Agentic CLI sharing the agent-core library
• Omni Terminal -- GPU-accelerated terminal emulator
• persona.json -- Portable entity identity spec
• life.json -- Portable human identity spec

License

The code in this repository is licensed under Apache 2.0, © Omni LLC. See LICENSE.md for more information.