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)
| File | Size | Uploaded | |
|---|---|---|---|
| tower_cli-0.3.3.tar.gz | 114.5 kB | Details |
Built distributions (wheels)
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
|