Eyra is a local-first voice agent for the macOS terminal. You speak or type, Eyra plans the route locally, calls tools when needed, and keeps computer-changing work cancellable, inspectable, and recoverable. Default behavior: Ollama at localhost, Local Whisper for voice, Silero VAD in process, screenshots in memory, sandboxed file access, no telemetry, and no silent network calls. Setup is guided and plain-language. If local AI, microphone access, or speech is not ready yet, Eyra names the next step instead of leaving you with a traceback. Open eyra menu for menu bar controls, eyra open for the local Web UI, or eyra examples for concrete first prompts and local workflows.

Install Eyra

Use the guided installer or source setup to prepare local AI, voice, and the eyra command.

Menu bar

Start, stop, diagnose, and tune Eyra from the macOS menu bar.

Use voice

Run spoken turns, dictation, approvals, interruption, and hands-free status.

Understand the architecture

Follow the runtime, router, tools, connectors, jobs, Web UI, and privacy boundary.

Verify releases

Run the local voice-to-computer certification matrix and project checks.

Product promise

Eyra is the coordinator, not the worker pile. It keeps the local voice-to-computer workflow useful without making privacy and recovery vague. Tools, Web UI, Realtime voice, connectors, MCP, OS control, browser work, and terminal-agent delegation are available only when you enable the matching capability.

Runtime model

input
  ├─ typed prompt
  └─ local voice turn

local policy router

deterministic action, model turn, tool loop, connector job, or background task

status, speech, logs, ledger, artifacts, cancellation, undo

What stays local

SurfaceDefault
Model endpointhttp://localhost:11434/v1
Voice inputLocal Whisper through socket or CLI
Speech outputLocal Whisper TTS
ScreenshotsCaptured and encoded in memory
FilesSandboxed under configured roots
Network toolsDisabled
Web UIDisabled
Realtime voiceDisabled
ConnectorsDisabled
External agents and MCPDisabled
Data leaves the machine only when you configure a remote model provider, enable Realtime voice, enable network-backed tools and use them, or opt into a remote connector.

Main paths