tuspy

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 on this page — 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

tuspy on PyPI

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

Evidence: tuspy-1.1.0-py3-none-any.whl

Tags

More Python Modules packages