Aximo

Local, CPU-first speech-to-text API in Rust. Run your own Parakeet or GigaAM models, transcribe audio over HTTP, and receive partial/final results over WebSocket. No cloud transcription account is required.

• HTTP API for WAV, MP3, FLAC, M4A/MP4, and raw PCM
• Browser microphone recorder at /docs/
• Health checks, capability discovery, and Prometheus metrics
• English and Russian support depends on the selected model; check /v1/capabilities

The bundled adapters use bounded buffered realtime, not native incremental decoding. See capabilities and limits.

Quick start

With Docker Compose, Git, Bash, curl, and tar installed:

git clone https://github.com/agent-axiom/aximo.git
cd aximo
./scripts/fetch-models.sh
docker compose up --build

The first run downloads the Parakeet model and builds the service. Open http://127.0.0.1:8080/docs/ after it reports ready.

Already have Rust and a native build toolchain? From the checkout:

./scripts/fetch-models.sh
cargo build --release --locked -p aximo
AXIMO_CONFIG=config/aximo.local.toml ./target/release/aximo

See installation for prerequisites, installing the binary, model setup, and verification.

Transcribe a file

In another terminal, send an existing audio file:

curl --fail-with-body http://127.0.0.1:8080/v1/transcriptions \
  -H 'Content-Type: audio/wav' --data-binary @sample.wav

The JSON response contains text, segments, engine, and timing metadata. For voice input in your terminal or Claude Code, see terminal voice integration.

Documentation

• Installation and first-run checks
• API reference and browser recorder · client examples · realtime protocol
• Configuration · operations and troubleshooting
• Architecture · development and CI
• Model licenses · benchmarks · benchmark baselines
• Deployment security · Kubernetes · publishing

Demo and security

Try the public browser demo. It may cold-start and run slowly; only upload audio you are comfortable sending to that public service. Use a local installation for private audio.

Aximo has no built-in authentication. Keep it on loopback or behind an authenticated gateway before exposing it to other machines. See deployment security and security reporting.