Skip to main content

Tower CLI

The Tower CLI is one of the main ways to interact with the Tower environment. You can do basically everything you need inside the Tower CLI, including run your code locally or remotely in the Tower cloud.

Installing the Tower CLI

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

$ pip install -U tower-cli

You can also download the CLI directly from one of our releases.

Using the Tower CLI

There are two big components in the Tower CLI reposiory: The CLI itself and the runtime environment for the Tower cloud. We host the runtime in this repository and pull it in to our internal code because we want to ensure that the environments behave exactly the same locally and in our cloud!

Using the CLI

It's pretty straight forward! But here's what it looks like right now.

$ tower
Tower is a compute platform for modern data projects

Usage: tower [OPTIONS] <COMMAND>

Commands:
  login    Create a session with Tower
  apps     Interact with the apps that you own
  secrets  Interact with the secrets in your Tower account
  deploy   Deploy your latest code to Tower
  run      Run your code in Tower or locally
  version  Print the current version of Tower
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help                   Print help

About the runtime environment

The tower-runtime crate has the Rust library that makes up the runtime environment itself. All the interfaces are defined in the main crate, and the local package contains the invokation logic for invoking tower packages locally.

To learn more about tower packages, see the tower-package crate.

Contributing

We welcome contributions to the Tower CLI and runtime environment! Please see the CONTRIBUTING.md file for more information.

Code of Conduct

All contributions must abide by our code of conduct. Please see CODE_OF_CONDUCT.md for more information.

Development

Here are a few handy tips and common workflows when developing the Tower CLI.

Python SDK development

We use uv for all development. You can spawn a REPL in context using uv very easily. Then you can import tower and you're off to the races!

uv run python

If you need to get the latest OpenAPI SDK, you can run ./scripts/generate-python-api-client.sh.

Metadata

Release files for tower-cli 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tower-cli 0.3.3
File Size Uploaded
tower_cli-0.3.3.tar.gz 114.5 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for tower-cli 0.3.3
File
tower_cli-0.3.3-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details
tower_cli-0.3.3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
tower_cli-0.3.3-py3-none-win32.whl Python 3 none Windows x86-32 Details
tower_cli-0.3.3-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details
tower_cli-0.3.3-py3-none-musllinux_1_2_i686.whl Python 3 none Linux musl 1.2+ x86-32 Details
tower_cli-0.3.3-py3-none-musllinux_1_2_armv7l.whl Python 3 none Linux musl 1.2+ ARMv7l Details
tower_cli-0.3.3-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details
tower_cli-0.3.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details
tower_cli-0.3.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details
tower_cli-0.3.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
tower_cli-0.3.3-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
tower_cli-0.3.3-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details
tower_cli-0.3.3-py3-none-linux_armv6l.whl Python 3 none linux armv6l Details

Total release size: 61.0 MB

Release files / tower_cli-0.3.3.tar.gz

Download URL tower_cli-0.3.3.tar.gz
Size 114.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a120e0775fa337ee7bd4e3be4fb6764e86162a0d74377d585f7bc485b9d6f689
BLAKE2b-256 checksum
How to use checksums
bdc6b25268492da0fd27cd8c63f29932953750d8c3aea7b7f2134f34bc714595
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-win_arm64.whl

Download URL tower_cli-0.3.3-py3-none-win_arm64.whl
Size 3.0 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
d97bd13be4306c63ee1304f50c79c3d302bcd843a6ac195116cbd59d9fd5785b
BLAKE2b-256 checksum
How to use checksums
d22a3bf81afd4e1e55a2b7897740672ca048be63edbc43d95bcc66cf4b1a729e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-win_amd64.whl

Download URL tower_cli-0.3.3-py3-none-win_amd64.whl
Size 3.1 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
59e89e151a2979b7e773d39350c9a20051e31dcb717d7befc5b39678cc2c46e3
BLAKE2b-256 checksum
How to use checksums
639deae0955d8ff946c133db79ab765d7409f05232c8a08dc6d1b069afdb5df6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-win32.whl

Download URL tower_cli-0.3.3-py3-none-win32.whl
Size 2.9 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
e537d510e64329a59b9e48ef6d8df8720cff9bb78cfb06b91ab5ea84c65cce70
BLAKE2b-256 checksum
How to use checksums
6394a66cf59fb8e9b962afccf7af033a6e8c8524137dd70a22964c060b584e81
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-musllinux_1_2_x86_64.whl

Download URL tower_cli-0.3.3-py3-none-musllinux_1_2_x86_64.whl
Size 5.7 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
d52d3157c3ff40a3129e764636dbb9c3d7f238fd7fc990031c9eaef9b777dc67
BLAKE2b-256 checksum
How to use checksums
ded45698f43e51b47b45b8a154d43863795115b8ae9993b4e3c9e7f59f704382
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-musllinux_1_2_i686.whl

Download URL tower_cli-0.3.3-py3-none-musllinux_1_2_i686.whl
Size 5.8 MB
Tags Linux musl 1.2+ x86-32 Python 3
SHA-256 checksum
How to use checksums
172d8a83967ac82a882247b0744d9d265888203e476e48f2d809eff7d1c260ff
BLAKE2b-256 checksum
How to use checksums
2734f00b1ff7a2a6c60121368820f5e91bdb7194f33a54a88f9880cd166f5056
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-musllinux_1_2_armv7l.whl

Download URL tower_cli-0.3.3-py3-none-musllinux_1_2_armv7l.whl
Size 5.3 MB
Tags Linux musl 1.2+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
8a3acffc55089f2d259984eb9c00369b6d481e8a06e25deae9ba5bce43277e9c
BLAKE2b-256 checksum
How to use checksums
c728f90e4191f4eed14543231a1c4988df19b603780d4154d8646120b26aadfd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-musllinux_1_2_aarch64.whl

Download URL tower_cli-0.3.3-py3-none-musllinux_1_2_aarch64.whl
Size 6.1 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
6b8b21b33f2d1f657c58857c04d26f19050373c526e2ec66a907b1cfed795a19
BLAKE2b-256 checksum
How to use checksums
8acd143838a39f7c5ac3c05393bb3fdea4b02ae9c33a4ae4663f87c47cb53d65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL tower_cli-0.3.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 5.7 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
5f097a878692f154fa1fd08a2f28e456e16adca4c9206d592ad01068fa92baf5
BLAKE2b-256 checksum
How to use checksums
0ac42665c192d6d33198abec2faba55addf18cf63b488c0396e1b2484f728b3d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL tower_cli-0.3.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Size 5.2 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
4205edb053590cedfbc37fc04e44668e43e0b6d3cc79d840dbc4615d6a250113
BLAKE2b-256 checksum
How to use checksums
64476bcb291c4cf26f8cf9640f830f8fb27459f4c1c1af8a56befbab40873728
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL tower_cli-0.3.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 5.9 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
195957a9a3143bc425e5fe28f0ede9bd4a717296eb2970fe96bd187ab356c0ea
BLAKE2b-256 checksum
How to use checksums
62465f2e4c0d9cfbc2cf18dc8994e08dbff5a130b84984c0f8c7d94f0169f5f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-macosx_11_0_arm64.whl

Download URL tower_cli-0.3.3-py3-none-macosx_11_0_arm64.whl
Size 3.4 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
e60792a157a24e0f7a136a11baed27e081b15fbdc3f674803ee127315f2bc72a
BLAKE2b-256 checksum
How to use checksums
ecebe46ece873257a1ccb30b7d4e328024b59bbbbe00c7b589f2b7997fc5216d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-macosx_10_12_x86_64.whl

Download URL tower_cli-0.3.3-py3-none-macosx_10_12_x86_64.whl
Size 3.5 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
0ff3ee0e8e4ad16032d3a57608e25c73600db806234dc463b05ca36b2f0f2348
BLAKE2b-256 checksum
How to use checksums
6a8d0ff8bcae8857d9fb9f21bc95b3fb4585729c15932412a38cde7409d34a17
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12

Release files / tower_cli-0.3.3-py3-none-linux_armv6l.whl

Download URL tower_cli-0.3.3-py3-none-linux_armv6l.whl
Size 5.4 MB
Tags Python 3 linux armv6l
SHA-256 checksum
How to use checksums
d81e79d8f41f4a445e63a9546033b33c5e91180f7b005354f01552ff5b9795db
BLAKE2b-256 checksum
How to use checksums
27add94dc8bc6ba66ad8180662830641378aec5fc9968c17c8303caac2cba40b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.6.12
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