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
TONEandINPUTcan each be literal text or a path to a file.MODELdefaults togemini-4-neon(orTOV_MODELif 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 MODELreads the input from stdin. - When
TOV_TONEis set,tov INPUT MODELuses the tone from the environment, whiletov 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.