Skip to content

Installation

TenorTUI requires Python 3.11 or newer.

pipx installs Python apps in isolated environments and puts the entry-point on your PATH.

pipx install tenor-tui

Then run:

tenortui

Alternative: pip

pip install --user tenor-tui

You may need to add ~/.local/bin to your PATH for the tenortui command to be found.

From source

git clone https://github.com/jayrav13/tenor-tui.git
cd tenor-tui
poetry install
poetry run tenortui

Configuration directory

On first launch, TenorTUI creates ~/.config/tenor/:

  • config.yaml — provider selection, theme, etc.
  • history.json — recently viewed tickers
  • watchlists.json — your watchlists

See Configuration for the full list of options.

Choosing a provider

The default provider is Yahoo Finance — no API key required, no signup.

If you have a Tradier account, you can use the Tradier provider for richer Greeks data:

tenortui --provider tradier

See Providers for the full comparison.