---
id: tuspy
version: "1.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# tuspy — A Python client for the tus resumable upload protocol ->  http://tus.io

License: permissive · Maintenance: active · Downloads: 4.9M/mo

## What it is and what it does

tuspy is a Python client library that implements the tus protocol, an HTTP-based standard for resumable file uploads. It wraps the mechanics of chunked uploads and server communication, letting you upload files in pieces that can survive network interruptions, user pauses, or server outages without losing progress. The package provides both a high-level client interface and a standalone uploader for direct use when you already know the upload endpoint.

It depends on requests, tinydb, and aiohttp to handle HTTP communication and local state. You instantiate a client with a server URL, create an uploader from a file path or stream, and call upload() to send the file in configurable chunks. You can pause mid-upload, resume later, or upload specific byte ranges—the server tracks what has arrived, so you never retransmit data unnecessarily.

Use it for:

- Upload large files through unstable networks where a single connection failure would restart the entire transfer
- Build web applications that let users pause and resume file uploads without losing progress
- Integrate with tus-compatible servers to offload resumable upload logic to a dedicated service
- Handle file uploads in mobile or IoT contexts where connectivity is intermittent
- Reduce bandwidth waste by resuming partial uploads instead of starting over after a connection drop

## Worth the install?

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

A Python client for uploading files to servers using the tus resumable upload protocol, which allows paused and resumed uploads without re-uploading previously sent data.

Yes, if you need resumable uploads to a tus-compatible server. The package has low install friction, active maintenance (last commit 2026-07-11), permissive MIT licensing, no known vulnerabilities, and proven adoption in top 5000 PyPI. The Alpha classifier warrants checking the project's current stability stance, but recent activity and download volume suggest it is production-ready for its intended use case.

## Install

pip install tuspy
uv add tuspy
poetry add tuspy

## Installing tuspy

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with last commit on 2026-07-11; marked Alpha status but in top 5000 PyPI packages by downloads.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart:

pip install tuspy

from tuspy import client
my_client = client.TusClient('http://tusd.tusdemo.net/files/')
uploader = my_client.uploader('path/to/file.ext', chunk_size=200)
uploader.upload()

Verify before relying:

- Whether the package's Alpha status reflects active development or stability concerns
- Performance characteristics when uploading large files or over slow connections
- Specific use cases where requests, tinydb, and aiohttp are each required

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

resumable file upload client, tus protocol python, http resumable uploads, pause and resume file uploads, chunked file upload, network-resilient uploads, tus server client, resumable-uploads, http-protocol, file-transfer

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