---
id: streaming-form-data
version: "2.1.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# streaming-form-data — Streaming parser for multipart/form-data

License: permissive · Maintenance: active · Downloads: 528.7K/mo

## What it is and what it does

streaming_form_data is a Python parser for multipart/form-data streams, the encoding used when HTML forms submit data over HTTP. Instead of buffering the entire request body in memory, it processes incoming chunks as they arrive, making it suitable for handling large file uploads without memory exhaustion.

The parser works by registering target handlers for named form fields—you can write to local files, cloud storage (S3, GCS), discard data, or capture values. It depends on smart-open for cloud storage abstraction and aiofiles for async file operations. The package includes a C extension for performance and is actively maintained with wheels for Python 3.10–3.14 on major platforms.

Use it for:

- Upload gigabyte-sized files through a web form without consuming proportional memory.
- Stream form submissions directly to S3 or Google Cloud Storage without intermediate local buffering.
- Parse multipart requests in FastAPI or Flask applications where standard form handling is too slow.
- Process form data in resource-constrained environments (embedded systems, serverless functions) where memory is limited.
- Handle concurrent file uploads by processing each stream independently without blocking.

## Worth the install?

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

Parses multipart/form-data streams chunk-by-chunk without buffering entire payloads, enabling efficient handling of large file uploads in web applications.

Yes, if you need to handle large file uploads or memory-constrained streaming scenarios. The active maintenance, permissive license, and availability of pre-built wheels make it low-risk. The C extension requirement adds modest friction on non-standard platforms, but wheels cover common environments. No known vulnerabilities. Suitable for production use in web applications.

## Install

pip install streaming-form-data
uv add streaming-form-data
poetry add streaming-form-data

## Installing streaming-form-data

Before you install: Medium install friction due to C extension compilation requirement. The package is actively maintained with a recent release (65 days ago) and supports current Python versions (3.10–3.14). Pre-built wheels are available for common platforms (macOS ARM64, Linux x86_64, Windows), reducing friction on standard environments.

License in practice: Licensed under MIT (permissive), so you can use it freely in commercial and open-source projects without copyleft obligations.

Quickstart:

from streaming_form_data import StreamingFormDataParser
from streaming_form_data.targets import FileTarget, ValueTarget

headers = {"Content-Type": "multipart/form-data; boundary=boundary"}
parser = StreamingFormDataParser(headers=headers)
parser.register("file", FileTarget("/path/to/file.txt"))
parser.register("name", ValueTarget())

for chunk in request.body:
    parser.data_received(chunk)

Requires a working C compiler to build the C extension during installation (on Debian-based systems, typically the build-essentials package).

Verify before relying:

- Whether the package works with async frameworks like FastAPI out of the box or requires additional integration.
- Performance characteristics and memory overhead compared to standard form parsing in specific web frameworks.
- Whether S3Target and GCSTarget require additional credentials or configuration beyond what the fact sheet shows.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 528.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

streaming multipart form data parser, large file upload handler, chunked form data parsing, memory-efficient form parsing, http multipart streaming, form data without buffering, web upload streaming, streaming-io, form-parsing, web-upload

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