Installation

Install and configure the TensorPool CLI

1. Install the TensorPool CLI

   Install the CLI using pip:

   pip install tensorpool
   

   Verify the installation:

   tp --version
   
2. Configure Your API Key

   Set your API key as an environment variable:

   export TENSORPOOL_KEY="your_api_key_here"
   

   Get your API key from the TensorPool dashboard

   Make It Persistent

   To avoid setting the API key every time you open a new terminal, add it to your shell profile.

   Not sure which shell you’re using? See the Shell Configuration guide to learn about different shells and how to determine which one you have.

   Zsh

   echo 'export TENSORPOOL_KEY="your_api_key_here"' >> ~/.zshrc
   source ~/.zshrc
   

   Bash

   echo 'export TENSORPOOL_KEY="your_api_key_here"' >> ~/.bashrc
   source ~/.bashrc
   

   Fish

   echo 'set -gx TENSORPOOL_KEY "your_api_key_here"' >> ~/.config/fish/config.fish
   source ~/.config/fish/config.fish
   
3. Verify Your Setup

   Check that everything is configured correctly:

   tp me
   

   This displays your account information, confirming that your API key is working.

4. Set Up SSH Keys

   SSH keys are required to access clusters and pull job outputs. If you don’t have SSH keys yet, generate them:

   ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
   

   Then add your public key to your TensorPool account:

   tp me sshkey add ~/.ssh/id_ed25519.pub
   

   Once saved, your SSH key will automatically be used for all new clusters — no need to pass -i every time.

   You can also manage SSH keys from the TensorPool dashboard.

Next Steps

Deploy a Job

Run your first training job

Deploy a Cluster

Create your first GPU cluster