Table of contents

Installation

Install the Podstack Python SDK to programmatically manage your GPU cloud resources.

Requirements

  • Python 3.8 or higher
  • pip package manager
  • API token from your Podstack account

Install via pip

pip install podstack

Install with Optional Dependencies

# With async support
pip install podstack[async]

# With all extras
pip install podstack[all]

Verify Installation

import podstack
print(podstack.__version__)

Or from the command line:

python -c "import podstack; print(podstack.__version__)"

We recommend using a virtual environment to avoid dependency conflicts:

# Create virtual environment
python -m venv podstack-env

# Activate (Linux/macOS)
source podstack-env/bin/activate

# Activate (Windows)
podstack-env\Scripts\activate

# Install SDK
pip install podstack

Development Installation

For contributing or development:

git clone https://github.com/podstack/python-sdk.git
cd python-sdk
pip install -e ".[dev]"

Upgrading

pip install --upgrade podstack

Troubleshooting

Import Error

If you get an import error, ensure you’re using the correct Python environment:

which python
pip show podstack

SSL Certificate Errors

On some systems, you may need to update certificates:

pip install --upgrade certifi

Proxy Configuration

For corporate networks with proxy:

pip install podstack --proxy http://proxy.example.com:8080

Next Steps