voxagent

Voice-powered terminal agent. Speak commands, get answers. Nothing leaves your machine.

$ npm install -g voxagent Copied!
voxagent
$ voxagent
voxagent v0.1.0 — voice-powered terminal
Ollama connected. Model: llama3.2
Whisper model ready.
Press ENTER to speak...
[Recording...] Press ENTER to stop.
Transcribing...
You: What's the default port for PostgreSQL?
Thinking...
PostgreSQL runs on port 5432 by default. This is the standard
port configured in postgresql.conf under the "port" setting.
Press ENTER to speak...

How it works

Three steps, all on your machine. No cloud, no API keys, no network calls.

Step 01
🎙️

You speak

decibri captures microphone audio as raw PCM. Cross-platform, prebuilt binaries.

Step 02
📝

Whisper transcribes

whisper.cpp converts speech to text locally. GPU-accelerated when available.

Step 03
🤖

Ollama responds

Your local LLM generates the answer. Any Ollama model. Default: llama3.2.

Built for developers

A voice interface that respects your machine, your data, and your workflow.

Fully offline

No cloud services. No API keys. No accounts. No recurring cost. Everything runs on your hardware.

Cross-platform

Windows, macOS, and Linux. Prebuilt native binaries via decibri handle platform differences.

Any model

Works with any Ollama model. Swap models with --model mistral or use the default llama3.2.

Privacy first

No audio is recorded, stored, or transmitted. Ever. Your voice stays on your machine.

Open source

Apache 2.0 licensed. Inspect the code, contribute, or fork it. Built in the open on GitHub.

Debug mode

Run with --debug to see audio levels, capture duration, and raw whisper output.

Quick start

Three commands. No configuration needed.

# Install voxagent
$ npm install -g voxagent
# Make sure Ollama has a model
$ ollama pull llama3.2
# Run
$ voxagent

Requirements

Minimal setup. No cloud accounts.

✓  Node.js 18+
✓  Ollama running locally
✓  A microphone
First run downloads a whisper model (~150 MB). Cached locally for future use.

Powered by

Built on proven open-source foundations.