Skip to content

INSTALL-AND-REFERENCE.md

Latest commit

 

History

History
177 lines (127 loc) · 4.1 KB

INSTALL-AND-REFERENCE.md

File metadata and controls

177 lines (127 loc) · 4.1 KB

Tower CLI — Installation and Reference

Detailed installation options, optional features, and CLI reference for advanced setups.

For a quick start, see the main README.md. For contributor development setup, see DEVELOPMENT.md.

Installing the Tower CLI

Recommended (most users)

The main way to install the CLI is using the pip package manager:

pip install -U tower

Verify installation:

tower version

You can also download the CLI from releases.

Nix Flake

If you have Nix installed with flakes enabled, you can install the latest version of the Tower CLI as follows.

Profile

nix profile install github:tower/tower-cli

NixOS / nix-darwin

If you use NixOS or nix-darwin with flakes:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    tower-cli.url = "github:tower/tower-cli";
  };

  outputs = { self, nixpkgs, tower-cli, ... }@inputs: {
    # with nix-darwin:
    # darwinConfigurations.your-hostname = darwin.lib.darwinSystem {
    nixosConfigurations.nixos = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [{
        environment.systemPackages = [ tower-cli.packages.${system}.tower ];
      }];
    };
  };
}

Devenv

If you use devenv, add tower-cli to your project:

# devenv.yaml
inputs:
  tower-cli:
    url: github:tower/tower-cli
# devenv.nix
{ inputs, pkgs, ... }:
{
  packages = [
    inputs.tower-cli.packages.${pkgs.stdenv.system}.tower
  ];
}

Using the CLI

Both the Tower CLI and the cloud runtime live in this repository to ensure that Tower local and cloud execution environments behave identically.

Command overview

tower
Tower is a compute platform for modern data projects

Usage: tower [OPTIONS] [COMMAND]

Commands:
  login         Create a session with Tower
  apps          Manage the apps in your current Tower account
  schedules     Manage schedules for your Tower apps
  secrets       Interact with the secrets in your Tower account
  environments  Manage the environments in your current Tower account
  deploy        Deploy your latest code to Tower
  run           Run your code in Tower or locally
  version       Print the current version of Tower
  teams         View information about team membership and switch between teams
  mcp-server    Runs an MCP server for LLM interaction
  help          Print this message or the help of the given subcommand(s)

Options:
  -j, --json  Output results in JSON format
  -h, --help  Print help

Optional features

Tower supports optional installation extras. Install only what you need.

AI/LLM support

pip install "tower[ai]"
  • tower.llms: language model integration

Apache Iceberg support

pip install "tower[iceberg]"
  • tower.create_table: create Iceberg tables
  • tower.load_table: load data from Iceberg tables

dbt Core support

pip install "tower[dbt]"

Provides dbt Core integration for running dbt workflows:

import tower

workflow = tower.dbt(
    project_path="path/to/dbt_project",
    profile_payload=tower.dbt.load_profile_from_env("DBT_PROFILE_YAML"),
    commands="deps,seed,build",
)

results = workflow.run()

Available helpers:

  • tower.dbt.load_profile_from_env(): load dbt profile from environment variables
  • tower.dbt.parse_command_plan(): parse comma-separated commands into a command plan
  • tower.dbt.DbtCommand: represents a dbt CLI command invocation
  • tower.dbt.DbtRunnerConfig: low-level configuration class
  • tower.dbt.run_dbt_workflow(): low-level execution function

For a complete example, see the dbt Core Ecommerce Analytics app.

All optional features

pip install "tower[all]"

Check available features

import tower
import pprint

pprint.pprint(tower.get_available_features())
print(tower.is_feature_enabled("ai"))