---
id: filestack-python
version: "4.0.0"
license: Apache 2.0
license_treatment: permissive
maintenance: dormant
---

# filestack-python — Filestack Python SDK

License: permissive · Maintenance: dormant · Downloads: 134.6K/mo

## What it is and what it does

Filestack-python is the official Python SDK for Filestack, a file uploading and transformation service. It provides two main classes—Client for uploading files and Filelink for managing already-uploaded files—along with chainable transformation methods for resizing, flipping, enhancing, and converting media. The SDK handles both standard and intelligent multipart uploads, supports security policies with signed API calls, and includes webhook verification helpers.

The package depends on requests for HTTP communication and trafaret for data validation. It supports Python 3.7 through 3.12 and is classified as Beta. It serves developers integrating Filestack's file management and transformation capabilities into Python applications.

Use it for:

- Upload files to Filestack and retrieve CDN URLs for storage and distribution.
- Apply chainable image transformations (resize, flip, enhance) on uploaded or external files.
- Convert audio and video files while monitoring conversion status and retrieving results.
- Implement secure file operations using signed API calls with expiry policies.
- Verify incoming Filestack webhooks to ensure authenticity of server-sent events.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Official Python SDK for Filestack that handles file uploads, transformations, and management through the Filestack API and content management system.

Yes, with conditions. The package is stable, well-documented, and carries no known vulnerabilities. Install it if you are integrating with Filestack and can tolerate dormant maintenance (last release 696 days ago). Avoid it if your project requires active SDK development or rapid response to API changes; in that case, verify that Filestack's service itself remains current and that the SDK's feature set matches your needs.

## Install

pip install filestack-python
uv add filestack-python
poetry add filestack-python

## Installing filestack-python

Before you install: Low install friction with only two runtime dependencies (requests and trafaret). Maintenance is dormant—last release was 696 days ago, though the repository remains active with a commit on 2024-09-17. Suitable for stable use cases but not for projects requiring active development or rapid bug fixes.

License in practice: Licensed under Apache 2.0 (permissive), which allows commercial use, modification, and distribution with minimal restrictions. Safe for most projects.

Quickstart:

pip install filestack-python

from filestack import Client
client = Client('YOUR_API_KEY')
new_filelink = client.upload(filepath='path/to/file')
print(new_filelink.url)

Requires a valid Filestack API key to authenticate and use the service.

Verify before relying:

- Whether the dormant maintenance status affects compatibility with current Filestack API endpoints.
- Whether trafaret dependency is actively maintained and compatible with modern Python versions.
- Current download volume and adoption metrics for this package.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 134.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

file upload sdk python, image transformation api, file management filestack, cloud file storage python, media processing sdk, file-upload, media-transformation, cloud-storage

[View on SkillFed](https://skillfed.io/packages/filestack-python) · [View on PyPI](https://pypi.org/project/filestack-python/)