Skip to main content

navig-media-core

The shared media engine NAVIG's media packages run on — media types and the generator registry, the generation service, the refs library, the variant store, the provider key catalog, and the ffmpeg primitives (audio edit, video edit, frames, fx). A library: no commands of its own, runs without navig.

A navig library — a shared engine package; install it as a dependency, no commands of its own · v0.1.0 · not on PyPI yet (install from source below)

Install

pip install "git+https://github.com/navig-run/plugins#subdirectory=navig-media-core"

It is a library, not a program: there is nothing to run — navig and the packages that use it pull it in as a dependency.

The shared media engine NAVIG's media packages run on — extracted from navig-generate so generate, audio, text and pipeline share one copy instead of reaching into a sibling plugin.

A library: no commands of its own, no navig dependency at import time, and nothing to configure — you install it because something else needs it (navig, navig-generate, navig-audio, navig-pipeline).

What lives here

Module What it is
navig_media_core.media.types MediaModality + the generator registry (register_generator) every facet plugs into
navig_media_core.media.generation_service generate / iterate / process — turns the stateless generators into the versioned workflow
navig_media_core.media.refs_library the append-only refs ledger (prompt, provider, seed, context, license)
navig_media_core.generated_media the SQLite mirror of that ledger (History gallery, short-id lookups)
navig_media_core.media.context_builder project context injected into every prompt (palette, style note, placement)
navig_media_core.tools.media_providers the provider catalog and resolve_media_key (env vars first, then the vault)
navig_media_core.media.audio_edit ffmpeg audio primitives: cut, concat, speed, excerpt, probe
navig_media_core.media.video_edit ffmpeg video primitives: join, captions, vertical fit, still, mix
navig_media_core.media.frames frame / scene extraction and probing
navig_media_core.media.fx glitch / punch-in effects driven by the beat grid

What stayed in navig-generate: the image/video/audio generator clients, beats, tonality, the pixel pipeline (processing), the deck routes and the CLI. The generation service reaches the generator clients through function-local imports, so this package never imports navig_generate at import time — navig-generate depends on this package, not the other way round.

Public paths did not change

navig.media.types, navig.media.generation_service, navig.media.audio_edit, navig.store.generated_media, navig.tools.media_providers — every public import path is still exactly what it was; the core shims now alias the modules here instead of their old navig_generate homes. Existing tests that patch those modules by dotted path keep patching the same (single) module object.

Install

Normally you never install it directly — pip install navig or pip install navig-generate pulls it in. On its own:

pip install navig-media-core

Metadata

Release files for navig-media-core 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for navig-media-core 0.1.0
File Size Uploaded
navig_media_core-0.1.0.tar.gz 61.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for navig-media-core 0.1.0
File Interpreter ABI Platform
navig_media_core-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 123.9 kB

Release history Release notifications | RSS feed

0.2.0

2 release files

0.1.1

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page