Skip to main content
The Spotify SDK for Python is available on PyPI and can be installed using standard Python package managers.

Requirements

Before installing, ensure you have a compatible Python version:
  • Python 3.10 or higher is required
  • Supported versions: 3.10, 3.11, 3.12, 3.13, 3.14
The SDK follows the official Python release cycle. All versions that have not reached end-of-life are supported.

Install with pip

1

Install the package

Run the following command in your terminal:
pip install spotify-sdk
This will install the SDK and all required dependencies:
  • httpx - HTTP client for making API requests
  • pydantic - Data validation and type hints
  • anyio - Async I/O abstraction
  • sniffio - Async library detection
2

Verify the installation

Check that the SDK is installed correctly:
import spotify_sdk
print(spotify_sdk.__version__)
You should see the installed version number (e.g., 0.9.1).

Install with uv

If you’re using uv, a fast Python package installer and resolver:
1

Add to your project

uv add spotify-sdk
This will add the SDK to your project’s dependencies and install it.
2

Verify the installation

import spotify_sdk
print(spotify_sdk.__version__)

Dependencies

The SDK has the following core dependencies, which are automatically installed:
PackageVersionPurpose
httpx≥0.28.1HTTP client for API requests
pydantic≥2.12.5Data validation and models
anyio≥4.12.1Async I/O support
sniffio≥1.3.1Async library detection
There are no optional dependencies. All required packages are installed automatically.

Development installation

If you want to contribute to the SDK or run it from source:
1

Clone the repository

git clone https://github.com/jonathan343/spotify-sdk.git
cd spotify-sdk
2

Install with uv

uv sync
This installs the SDK in editable mode with all development dependencies.
3

Run tests

uv run pytest

Next steps

Now that you have the SDK installed, you’re ready to start building:

Quickstart

Learn how to authenticate and make your first API call

Build docs developers (and LLMs) love