> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tensorpool.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install and configure the TensorPool CLI

<Steps>
  <Step title="Install the TensorPool CLI" icon="download">
    Install the CLI using pip:

    ```bash theme={null}
    pip install tensorpool
    ```

    Verify the installation:

    ```bash theme={null}
    tp --version
    ```
  </Step>

  <Step title="Configure Your API Key" icon="key">
    Set your API key as an environment variable:

    ```bash theme={null}
    export TENSORPOOL_KEY="your_api_key_here"
    ```

    <Note>
      Get your API key from the [TensorPool dashboard](https://tensorpool.dev/dashboard/profile)
    </Note>

    ### Make It Persistent

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

    <Note>
      Not sure which shell you're using? See the [Shell Configuration guide](/guides/shell-configuration) to learn about different shells and how to determine which one you have.
    </Note>

    <Tabs>
      <Tab title="Zsh">
        ```bash theme={null}
        echo 'export TENSORPOOL_KEY="your_api_key_here"' >> ~/.zshrc
        source ~/.zshrc
        ```
      </Tab>

      <Tab title="Bash">
        ```bash theme={null}
        echo 'export TENSORPOOL_KEY="your_api_key_here"' >> ~/.bashrc
        source ~/.bashrc
        ```
      </Tab>

      <Tab title="Fish">
        ```bash theme={null}
        echo 'set -gx TENSORPOOL_KEY "your_api_key_here"' >> ~/.config/fish/config.fish
        source ~/.config/fish/config.fish
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Verify Your Setup" icon="check">
    Check that everything is configured correctly:

    ```bash theme={null}
    tp me
    ```

    This displays your account information, confirming that your API key is working.
  </Step>

  <Step title="Set Up SSH Keys" icon="key">
    SSH keys are required to access clusters and pull job outputs. If you don't have SSH keys yet, generate them:

    ```bash theme={null}
    ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
    ```

    Then add your public key to your TensorPool account:

    ```bash theme={null}
    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.

    <Note>
      You can also manage SSH keys from the [TensorPool dashboard](https://tensorpool.dev/dashboard/ssh-keys).
    </Note>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Deploy a Job" icon="briefcase" href="/quickstart">
    Run your first training job
  </Card>

  <Card title="Deploy a Cluster" icon="server" href="/clusters-quickstart">
    Create your first GPU cluster
  </Card>
</CardGroup>