navig-audio

Speak text, transcribe audio, generate music and sound effects, analyse beats and render podcasts — its own navig-audio command, with your own provider keys; also navig audio / navig voice inside navig.

Works on its own — its own CLI, no navig required · v0.2.0 · PyPI

On its own (no navig needed)

pip install navig-audio
navig-audio --help   # no navig needed

With navig

pip install "navig[voice]"
navig audio --help

NAVIG Audio: speak text, transcribe audio, generate music and sound effects, make beats to rap on and render podcast episodes, with your own provider keys. It runs on its own as navig-audio, and inside navig as navig audio and navig voice.

On its own

pip install navig-audio                        # adds the `navig-audio` command
navig-audio voice speak "hello" -o hello.mp3   # edge-tts works with no key at all
navig-audio voice transcribe interview.m4a     # local Whisper; or OPENAI_API_KEY / DEEPGRAM_API_KEY
export ELEVENLABS_API_KEY=…                    # music, sound effects, cloned voices
navig-audio gen "lo-fi rain loop" --kind music
navig-audio beat analyse ref.mp3               # tempo · key · structure · spectrum → a style brief
navig-audio speed lecture.mp3 --rate 1.5       # ffmpeg on PATH for edits and beats
navig-audio draft notes.md                     # podcast scenario from rough notes (needs an AI, below)

Keys come from the environment or the shared encrypted vault (navig-vault), the same vault navig reads. draft and translate need an AI: navig's own when navig is installed, otherwise any key navig-sdk finds (OPENAI_API_KEY, OPENROUTER_API_KEY, GROQ_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY…), NAVIG_AI_BASE_URL for any OpenAI-compatible server, or a local Ollama. With none, they say how to set one up and exit 1.

Beats and audio edits run on navig-generate's media engine, which is installed with this.

Inside navig

The same commands are navig audio … and navig voice speak|transcribe|list-voices. navig also uses these engines for Telegram voice notes, agent voice input and inbox transcription; core's navig.voice.* modules re-export navig_audio.voice.*. The wake-word voice pipeline runs inside navig's gateway and needs navig.

Beats

navig-audio beat analyse ref.mp3 --card ref.md      tempo · key · structure · spectrum → a style brief
navig-audio beat styles [--styles house.yaml]       built-in genres + your own presets (a style may `extends:` another)
navig-audio beat plan --style boom-bap-dark --bpm 76   the arrangement in seconds — costs nothing
navig-audio beat gen  --style boom-bap-dark --bpm 76 --key Em -n 3 --out ./beats

gen renders from a composition plan whose sections are whole bars at the tempo you asked for (--structure intro:4,verse:16,hook:8,…), always instrumental, and then measures each file: the .json sidecar and the folder's INDEX.md carry target → measured tempo and key, with an off-tempo render flagged ⚠. --dry-run shows the exact request and sends nothing; --seed makes a keeper re-renderable.