# tus/tus-resumable-upload-protocol

Open Protocol for Resumable File Uploads

Repository: https://github.com/tus/tus-resumable-upload-protocol
Canonical: https://ross.abutalabs.com/products/tus-resumable-upload-protocol
Homepage: https://tus.io
License: MIT
License Family: permissive
Topics: protocol, tus, resumable, file-upload, mit, cross-platform, http, open-source
Last push: 2026-06-08T15:32:59+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 86, release rhythm 8, longevity 100
- inputs: {"age_days": 4897, "days_push": 86, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1725, forks 110 (observed 2026-08-28T04:05:28.112365+00:00)

## What it is
The tus resumable upload protocol is an open HTTP-based protocol specification for reliable, resumable file uploads that can be interrupted and continued from where they failed. This repository contains the protocol specification itself, plus an OpenAPI description, rather than a runnable client or server implementation.

## Use cases
- resume interrupted file uploads after network drops
- implement a resumable upload server in any language
- build a file uploader that supports pause and resume
- upload large videos over unreliable mobile networks
- generate tus-compatible clients and servers from an OpenAPI spec
- standardize file upload handling across platforms

## When to choose
- you need reliable uploads over flaky or mobile networks
- you want a language-agnostic, HTTP-based upload standard with many existing implementations
- you need pause/resume support for large file uploads
- you want a minimal, extensible protocol rather than a heavyweight SDK

## When to avoid
- you need a ready-made client or server library rather than a specification
- your uploads are small and rarely fail, making resumability unnecessary
- you need non-HTTP transports or exotic upload semantics outside the protocol's scope

## Facets
- artifact type: library
- maturity: stable
- function: file-upload, http-server, http-client, api-framework
- domain: web-development, apis, files, backend
- platform: cross-platform, browser
- tags: resumable-uploads, protocol-specification, http, openapi, upload-protocol, web-server, mobile, desktop

## Member repositories
- tus/tus-resumable-upload-protocol (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:28.112365+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:33:53.129594+00:00, confidence not recorded.
  - readme: https://github.com/tus/tus-resumable-upload-protocol (fetched 2026-08-28T04:05:28.112365+00:00, sha 4f724384e4f7)
  - homepage: https://tus.io (fetched 2026-08-29T11:09:35.744598+00:00, sha 61b6c0458b1b)
  - site_page: https://tus.io/faq (fetched 2026-08-29T11:09:35.753806+00:00, sha 11a1bb9f2257)
- Data as of 2026-08-30T08:39:29.467469+00:00.