Metadata-Version: 2.4
Name: navig-generate
Version: 0.2.1
Summary: Generate images, video and audio with your own provider keys, keep the variants you like, and edit them: cut, fx, beats, tonality, sprites. The media engine navig uses; runs on its own as `navig-generate`.
Author-email: NAVIG Development Team <opensource@navig.run>
License-Expression: Apache-2.0
Project-URL: Homepage, https://navig.run
Project-URL: Documentation, https://navig.run/docs
Keywords: navig,cli,agent,automation,plugin,ai,image,generation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: navig-sdk>=2.13.0
Requires-Dist: navig-vault>=0.7.0
Requires-Dist: httpx>=0.24
Requires-Dist: typer>=0.14.0
Requires-Dist: rich>=13.7.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: process
Requires-Dist: Pillow>=10.0; extra == "process"
Provides-Extra: beats
Requires-Dist: numpy>=1.24; extra == "beats"
Dynamic: license-file

# navig-generate

<!-- navig:plugin-card:start -->
<!-- Generated by scripts/gen_plugin_catalog.py — edit the plugin's pyproject.toml, not this block. -->

> Generate images, video and audio with your own provider keys, keep the variants you like, and edit them: cut, fx, beats, tonality, sprites. The media engine navig uses; runs on its own as `navig-generate`.

**Works on its own** — its own CLI, no navig required · v0.2.1 · [PyPI](https://pypi.org/project/navig-generate/)

**On its own** (no navig needed)

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

**With navig**

```bash
pip install "navig[generate]"
```

<details><summary>Commands</summary>

| Command | What it does |
|---|---|
| `navig generate contact-sheet` | Montage variants into a review contact sheet (Pillow). |
| `navig generate edit` | Instruction-edit an image variant (OpenAI gpt-image). |
| `navig generate gen` | Generate variant(s) into the active space's refs library. |
| `navig generate ingest` | Pull externally-generated files into the refs library for review (Midjourney, etc.). |
| `navig generate keep` | Promote a staged variant to the kept library. |
| `navig generate license` | Record the license for a variant (provenance). |
| `navig generate list` | List variants in THIS space, newest first (clickable). --all spans every space. |
| `navig generate palette` | Extract a hex palette from reference frames. |
| `navig generate process` | LOCAL pixel pipeline → a game-ready sprite variant (Pillow). |
| `navig generate redesign` | Reference-based img2img redesign (Recraft). |
| `navig generate reject` | Reject a staged variant (retained in .rejected, never deleted). |
| `navig generate rembg` | Remove the background → transparent PNG (Recraft). |
| `navig media contact-sheet` | Montage variants into a review contact sheet (Pillow). |
| `navig media edit` | Instruction-edit an image variant (OpenAI gpt-image). |
| `navig media gen` | Generate variant(s) into the active space's refs library. |
| `navig media ingest` | Pull externally-generated files into the refs library for review (Midjourney, etc.). |
| `navig media keep` | Promote a staged variant to the kept library. |
| `navig media license` | Record the license for a variant (provenance). |
| `navig media list` | List variants in THIS space, newest first (clickable). --all spans every space. |
| `navig media palette` | Extract a hex palette from reference frames. |
| `navig media process` | LOCAL pixel pipeline → a game-ready sprite variant (Pillow). |
| `navig media redesign` | Reference-based img2img redesign (Recraft). |
| `navig media reject` | Reject a staged variant (retained in .rejected, never deleted). |
| `navig media rembg` | Remove the background → transparent PNG (Recraft). |

</details>

<!-- navig:plugin-card:end -->

NAVIG **Generate**: make images, video and audio with **your own provider keys**, keep the
variants you like, and edit them. It is also navig's media engine (video cut/fx/captions,
audio edit, beats, tonality, frames), which navig itself runs on.

## On its own

```bash
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.media.<module>` and
`navig.tools.{image,video,audio}_generation` are identity aliases of this package's modules.
Deck screens need navig.
