Add asyncio client support

Author: kvz

CHANGELOG.md

@@ -1,5 +1,6 @@
 ### 2.0.0 / 2026-05-20 ###
 * **Breaking Change**: Raised the supported Python runtime floor from 3.9+ to 3.12+ so the SDK no longer has to retain vulnerable locked dependency versions for EOL Python 3.9 or depend on tooling lines that are already dropping older runtime support.
+* Added explicit asyncio support with `AsyncTransloadit`, async request/assembly/template helpers, and `asyncio.sleep`-based polling. Resumable uploads stay on the existing TUS client, but run through `asyncio.to_thread()` so the event loop remains responsive instead of pretending the sync uploader is natively async.
 * Raised the runtime HTTP stack to patched versions by requiring `requests` 2.33+ and adding an explicit `urllib3` 2.7+ floor.
 * Updated development and documentation tooling, including `pytest` 9.0.3, `Sphinx` 9.1, `sphinx-autobuild` 2025.8, `coverage` 7.14, `tox` 4.54, and `requests-mock` 1.12.
 * Updated CI and local Docker test coverage to a representative Python 3.12, 3.13, and 3.14 matrix.

README.md

@@ -36,6 +36,26 @@ print(assembly_response.data.get('assembly_id'))
 print(assembly_response.data['assembly_id'])
 ```
 
+## Async usage
+
+```python
+from transloadit.async_client import AsyncTransloadit
+
+async with AsyncTransloadit("TRANSLOADIT_KEY", "TRANSLOADIT_SECRET") as tl:
+    response = await tl.get_assembly(assembly_id="abc")
+    print(response.data["ok"])
+
+    assembly = tl.new_assembly()
+    assembly.add_step("resize", "/image/resize", {"width": 70, "height": 70})
+    with open("PATH/TO/FILE.jpg", "rb") as upload:
+        assembly.add_file(upload)
+        response = await assembly.create(wait=True, resumable=False)
+```
+
+The async client keeps polling on `asyncio.sleep`. Resumable uploads still use the existing TUS client, but are offloaded with `asyncio.to_thread()` so the event loop stays responsive.
+
+If you do not use `async with`, call `await tl.aclose()` when you are done with the session.
+
 ## Example
 
 For fully working examples, take a look at [`examples/`](https://github.com/transloadit/python-sdk/tree/HEAD/examples).

docs/source/index.rst

@@ -66,6 +66,25 @@ Usage
     # or
     print(assembly_response.data['assembly_id'])
 
+Async usage
+-----------
+
+.. code:: python
+
+    from transloadit.async_client import AsyncTransloadit
+
+    async with AsyncTransloadit('TRANSLOADIT_KEY', 'TRANSLOADIT_SECRET') as tl:
+        response = await tl.get_assembly(assembly_id='abc')
+        print(response.data['ok'])
+
+        assembly = tl.new_assembly()
+        assembly.add_step('resize', '/image/resize', {'width': 70, 'height': 70})
+        with open('PATH/TO/FILE.jpg', 'rb') as upload:
+            assembly.add_file(upload)
+            response = await assembly.create(wait=True, resumable=False)
+
+If you do not use ``async with``, call ``await tl.aclose()`` when you are done with the session.
+
 Example
 -------
 

docs/source/transloadit.rst

@@ -49,6 +49,38 @@ transloadit.request module
     :undoc-members:
     :show-inheritance:
 
+transloadit.async_client module
+-------------------------------
+
+.. automodule:: transloadit.async_client
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+transloadit.async_assembly module
+----------------------------------
+
+.. automodule:: transloadit.async_assembly
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+transloadit.async_template module
+----------------------------------
+
+.. automodule:: transloadit.async_template
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+transloadit.async_request module
+--------------------------------
+
+.. automodule:: transloadit.async_request
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 transloadit.response module
 ---------------------------
 
@@ -57,4 +89,3 @@ transloadit.response module
     :undoc-members:
     :show-inheritance:
 
-

poetry.lock

@@ -25,6 +25,7 @@ classifiers = [
     "Topic :: Multimedia :: Sound/Audio :: Conversion",
 ]
 dependencies = [
+    "aiohttp>=3.13.5,<4",
     "requests>=2.33,<3",
     "tuspy>=1.0.0,<2.0.0",
     "urllib3>=2.7,<3",