Skip to main content

tov

Rewrite text in a given tone of voice using Google Gemini, from the command line.

Install

uv tool install tov

or pipx install tov, or pip install tov. You'll need a Gemini API key in GEMINI_API_KEY.

To try it without installing:

uvx tov "Plain, friendly British English" "Please be advised that the office is closed."

As a single-file script

tov.py is self-contained: its dependencies are declared inline (PEP 723), so uv installs them automatically when you run it directly.

curl -fsSL https://raw.githubusercontent.com/tomdyson/tov/main/tov.py -o ~/.local/bin/tov
chmod +x ~/.local/bin/tov

Usage

tov TONE INPUT [MODEL]
tov INPUT [MODEL]              # with TOV_TONE set
echo "text" | tov TONE [MODEL] # INPUT omitted or "-" reads stdin
tov --version
  • TONE and INPUT can each be literal text or a path to a file.
  • MODEL defaults to gemini-4-neon (or TOV_MODEL if set).
  • The rewrite streams to stdout with nothing else added; errors go to stderr.

Examples

tov "Warm, plain British English. No jargon." "Per our previous correspondence, your application has been actioned."

pbpaste | tov ~/tone-guide.md | pbcopy

export TOV_TONE="Formal incident update for enterprise customers"
tov "server's down again lol" gemini-3.5-flash

A model name is recognised by its shape: a single lowercase hyphenated token such as gemini-3.5-flash. That lets tov work out what you meant:

  • When input is piped in, tov TONE MODEL reads the input from stdin.
  • When TOV_TONE is set, tov INPUT MODEL uses the tone from the environment, while tov TONE INPUT (second argument not model-shaped) overrides it.

If your input text happens to look like a model name, pass it explicitly with tov TONE - MODEL and pipe it in.

Environment

Variable Purpose
GEMINI_API_KEY Required. Your Gemini API key.
TOV_TONE Default tone guidance (text or path).
TOV_MODEL Default model.

Development

uv build                 # builds dist/tov-*.whl and .tar.gz
uv publish               # uploads to PyPI (needs a PyPI token)

Bump __version__ in tov.py before each release.

Licence

MIT — see LICENSE.

Metadata

Release files for tov 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 tov 0.1.0
File Size Uploaded Provenance Actions
tov-0.1.0.tar.gz 4.5 kB Without provenance Details for tov-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tov 0.1.0
File Interpreter ABI Platform Actions
tov-0.1.0-py3-none-any.whl Python 3 none any Details for tov-0.1.0-py3-none-any.whl

Total release size: 9.9 kB

Release files / tov-0.1.0.tar.gz

Download URL tov-0.1.0.tar.gz
Size 4.5 kB
Tags Source
SHA-256 checksum
How to use checksums
30ec5866cd33d57df38a40421b3dffe3fd48b9cb8b72f9257f4ea663e959a1b0
BLAKE2b-256 checksum
How to use checksums
e6bc9b974983594c557e2b5e34fc72d3400692c0a06fcfebc83186db188094ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / tov-0.1.0-py3-none-any.whl

Download URL tov-0.1.0-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c7b9a9f917ed0a6e7b2969ebc80c367e52cf6897c9e57a421c6fcf7ee43c0081
BLAKE2b-256 checksum
How to use checksums
59ac9c6346346b774ddcc5f64c5b668bf0954ba6c7aa53099c2bc9a72b1ec4cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for tov 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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