navig-generate

Generate images, video and audio with your own provider keys, keep the variants you like, and edit them: cut, fx, beats, tonality, sprites. Runs on its own as navig-generate; the shared media engine lives in navig-media-core.

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

On its own (no navig needed)

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

With navig

pip install "navig[generate]"

NAVIG Generate: make images, video and audio with your own provider keys, keep the variants you like, and edit them. It owns the generation service, the generator clients, beats, tonality and the sprite pipeline; the shared foundation it and navig run on (video cut/fx/captions, audio edit, refs library, variant store, provider catalog) is navig-media-core, which this package depends on.

On its own

pip install navig-generate                # adds the `navig-generate` command
export OPENAI_API_KEY=…                   # or RECRAFT_API_KEY, GEMINI_API_KEY, STABILITY_API_KEY…
navig-generate gen "a red fox, flat vector" --provider openai_gpt_image
navig-generate list                       # short ids; every command accepts them
navig-generate keep 8ab12f25
pip install "navig-generate[process]"     # Pillow: process / palette / contact-sheet
pip install "navig-generate[beats]"       # numpy: beat and tonality detection

Variants land in the project you stand in (<nearest folder with .navig/>/.navig/refs, else the current folder) and are recorded in <data dir>/generated_media.db — the same library navig reads, so nothing moves when you install navig later. Keys come from the environment or the shared encrypted vault (navig-vault). ffmpeg must be on PATH for video and audio edits.

Inside navig

The same commands are navig generate … (next to navig's analyse/briefing commands), and the deck's media screens use this engine. navig's old paths stay identity aliases: navig.media.{generation_service,beats,tonality,processing} and navig.tools.{image,video,audio}_generation from this package, the rest (navig.media.{types,refs_library,…}, navig.tools.media_providers) from navig-media-core. Deck screens need navig.