nanovt 0.2.0

CLI tool to extract audio from video files and transcribe it with OpenAI speech-to-text.

nanovt

Transcribe video or audio files with OpenAI speech-to-text.

The script extracts audio with ffmpeg, converts it to mono 16 kHz WAV, splits it into short chunks, transcribes each chunk with OpenAI, and writes a single text file.

Requirements

• Python 3.13+
• ffmpeg
• OPENAI_API_KEY in your environment

Installation

From PyPI:

pip install nanovt

Or install it as an isolated uv tool:

uv tool install nanovt

Usage

nanovt input.mp4

By default, input.mp4 writes input.txt.

To force a language, pass an optional language code. For example, English:

nanovt input.mp4 --language en

If --language is omitted, the model detects the language automatically.

Other useful options:

nanovt input.mp4 --chunk-seconds 180 --retries 3
nanovt input.mp4 --output transcript.txt
nanovt input.mp4 --keep-temp

For two-speaker dialogue transcription, enable speaker labels:

nanovt input.mp4 --diarize

This uses gpt-4o-transcribe-diarize by default and writes dialogue lines such as A: ... and B: ....

Development

uv sync --group dev
uv run pytest
uv run nanovt input.mp4

Releasing

Before the first release, confirm:

• The PyPI distribution name nanovt is available.
• The repository, homepage, and issue tracker URLs.
• PyPI Trusted Publishing is configured for this repository, workflow publish.yml, and environment pypi.

Bump the version in pyproject.toml, then build and check locally:

uv build
uvx twine check dist/*

Commit the version bump, tag the release, and push the tag:

git tag v0.1.0
git push origin v0.1.0

The Publish GitHub Actions workflow builds, verifies, and publishes the release to PyPI through Trusted Publishing. Approve the pypi environment if reviewers are configured.