Skip to main content

Install the CLI

Install the Teale command-line interface on macOS or Linux. The CLI has full feature parity with the GUI app --- 13 commands and 30+ subcommands covering inference, networking, wallet, and configuration.

Install​

macOS or Linux (Homebrew)​

brew install teale

Binary download​

Download the latest binary from GitHub Releases. Binaries are available for:

  • macOS (Apple Silicon)
  • macOS (Intel)
  • Linux (x86_64)
  • Linux (aarch64)

After downloading:

chmod +x teale
sudo mv teale /usr/local/bin/

Verify​

Check that Teale is installed and running:

teale status

You should see output showing the node status, loaded model, and network connectivity.

Quick reference​

teale up                    # Start the inference server
teale down                  # Stop the server
teale status                # Show node status and loaded model
teale chat "Hello!"         # Send a one-shot message
teale models list           # List available models
teale models pull <name>    # Download a specific model
teale wallet balance        # Check your USDC balance
teale config show           # Show current configuration

Run teale --help for the full command list, or teale <command> --help for details on any command.

Configuration​

Teale stores its configuration and models in ~/.teale/ on Linux and ~/Library/Application Support/Teale/ on macOS. You can override the data directory with:

export TEALE_HOME=/path/to/data

Uninstall​

brew uninstall teale

Or remove the binary manually:

sudo rm /usr/local/bin/teale
rm -rf ~/.teale  # Linux
rm -rf ~/Library/Application\ Support/Teale  # macOS

Next steps​