How to Install azure-storage-blob in Python
Microsoft Azure Blob Storage Client Library for Python
pip install azure-storage-blob
What is azure-storage-blob?
Microsoft Azure Blob Storage Client Library for Python
Azure Storage Blobs client library for Python Azure Blob storage is Microsoft's object storage solution for the cloud. Blob storage is optimized for storing massive amounts of unstructured data, such as text or binary data.
Serving images or documents directly to a browser Storing files for distributed access Streaming video and audio Storing data for backup and restore, disaster recovery, and archiving Storing data for analysis by an on-premises or Azure-hosted service
Source code | Package (PyPI) | Package (Conda) | API reference documentation | Product documentation | Samples
Quick Start
Minimal example to get started with azure-storage-blob:
import azure.storage.blob
print(azure.storage.blob.__version__)Installation
pip (standard)
pip install azure-storage-blobVirtual environment (recommended)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install azure-storage-blobpip3
pip3 install azure-storage-blobconda
conda install -c conda-forge azure-storage-blobPoetry
poetry add azure-storage-blobDependencies
Installing azure-storage-blob will also install these packages:
Verify the Installation
After installing, confirm the package is available:
python -c "import azure.storage.blob; print(azure.storage.blob.__version__)"If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.
Installation Errors
Common errors when installing azure-storage-blob with pip.
ModuleNotFoundError: No module named 'azure.storage.blob'
Cause: The package is not installed in the current Python environment.
Fix: Run pip install azure-storage-blob. If using a virtual environment, ensure it is activated first.
ModuleNotFoundError: No module named 'azure.storage.blob' (installed but still failing)
Cause: pip installed the package into a different Python than the one running your script.
Fix: Use python -m pip install azure-storage-blob to install into the interpreter you are running.
ImportError: cannot import name 'X' from 'azure.storage.blob'
Cause: The function or class does not exist in the installed version.
Fix: Check the version with pip show azure-storage-blob and upgrade with pip install --upgrade azure-storage-blob.
pip: command not found
Cause: pip is not in PATH or Python was not added to PATH during installation.
Fix: Try python -m pip install azure-storage-blob. On macOS/Linux try pip3.
PermissionError: [Errno 13] Permission denied
Cause: No write access to the system Python package directory.
Fix: Use a virtual environment, or add --user: pip install --user azure-storage-blob
SSL: CERTIFICATE_VERIFY_FAILED
Cause: pip cannot verify PyPI's SSL certificate — common behind corporate proxies.
Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org azure-storage-blob
Recent Releases
| Version | Released |
|---|---|
12.30.0b1 |
2026-04-01 |
12.29.0b1 |
2026-01-27 |
12.28.0 latest |
2026-01-06 |
12.28.0b1 |
2025-12-04 |
12.27.1 |
2025-10-29 |
Manage azure-storage-blob
Upgrade to latest version
pip install --upgrade azure-storage-blobInstall a specific version
pip install azure-storage-blob==12.28.0Uninstall
pip uninstall azure-storage-blobCheck what is installed
pip show azure-storage-blob