modal 1.5.1.dev12__tar.gz → 1.5.1.dev14__tar.gz

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.5.1.dev12
+Version: 1.5.1.dev14
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0
@@ -29,6 +29,9 @@ Requires-Dist: types-certifi
 Requires-Dist: types-toml
 Requires-Dist: watchfiles
 Requires-Dist: typing_extensions~=4.6
+Provides-Extra: api-proxy-support
+Requires-Dist: python-socks[asyncio]>=2.5; extra == "api-proxy-support"
+Requires-Dist: aiohttp-socks>=0.8; extra == "api-proxy-support"
 Dynamic: license-file
 
 # Modal Python SDK

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/_utils/blob_utils.py

@@ -218,7 +218,9 @@ async def perform_multipart_upload(
 
     expected_multipart_etag = hashlib.md5(b"".join(bin_hash_parts)).hexdigest() + f"-{len(part_etags)}"
     resp = await ClientSessionRegistry.get_session().post(
-        completion_url, data=completion_body.encode("ascii"), skip_auto_headers=["content-type"]
+        completion_url,
+        data=completion_body.encode("ascii"),
+        skip_auto_headers=["content-type"],
     )
     if resp.status != 200:
         try:

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/_utils/grpc_utils.py

@@ -4,6 +4,7 @@ import contextlib
 import os
 import platform
 import socket
+import ssl as ssl_module
 import time
 import typing
 import urllib.parse
@@ -11,7 +12,7 @@ import uuid
 from collections.abc import AsyncIterator, Sequence
 from dataclasses import dataclass, field
 from functools import cache
-from typing import Any, Optional, TypeVar
+from typing import Any, Optional, TypeVar, Union
 
 import grpclib.client
 import grpclib.config
@@ -19,7 +20,8 @@ import grpclib.events
 from google.protobuf.message import Message
 from google.protobuf.symbol_database import SymbolDatabase
 from grpclib import GRPCError, Status
-from grpclib.encoding.base import StatusDetailsCodecBase
+from grpclib.config import Configuration
+from grpclib.encoding.base import CodecBase, StatusDetailsCodecBase
 from grpclib.exceptions import StreamTerminatedError
 from grpclib.protocol import H2Protocol
 
@@ -65,17 +67,89 @@ class Subchannel:
         return True
 
 
-class PermanentCloseableChannel(grpclib.client.Channel):
-    def __init__(self, *args, closed_error_message: str, **kwargs):
-        super().__init__(*args, **kwargs)
+class ModalChannel(grpclib.client.Channel):
+    """Channel subclass with proxy support and graceful close guard.
+
+    Proxy support: routes connections through HTTP/SOCKS proxies by reading
+    standard env vars (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY).
+    Disabled when ``MODAL_DISABLE_API_PROXY=1`` is set.
+
+    Close guard: when ``closed_error_message`` is provided, raises
+    ``ClientClosed`` on new connection attempts after ``close()``.
+    """
+
+    def __init__(
+        self,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        *,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        path: Optional[str] = None,
+        codec: Optional[CodecBase] = None,
+        status_details_codec: Optional[StatusDetailsCodecBase] = None,
+        ssl: Union[None, bool, "ssl_module.SSLContext", "ssl_module.DefaultVerifyPaths"] = None,
+        config: Optional[Configuration] = None,
+        closed_error_message: Optional[str] = None,
+    ):
+        self.__use_unix_socket = path is not None
+        if not self.__use_unix_socket:
+            host = host if host is not None else "127.0.0.1"
+            port = port if port is not None else 50051
+
+        ssl_context: ssl_module.SSLContext | None
+        if ssl is True:
+            ssl_context = self._get_default_ssl_context()
+        elif isinstance(ssl, ssl_module.DefaultVerifyPaths):
+            ssl_context = self._get_default_ssl_context(verify_paths=ssl)
+        elif ssl is False:
+            ssl_context = None
+        else:
+            ssl_context = ssl
+
+        super().__init__(
+            host,
+            port,
+            loop=loop,
+            path=path,
+            codec=codec,
+            status_details_codec=status_details_codec,
+            ssl=ssl_context,
+            config=config,
+        )
+        self.__target_host = host
+        self.__target_port = port
+        self.__ssl_context = ssl_context
         self.__closed = False
         self.__closed_error_message = closed_error_message
 
     async def __connect__(self):
-        if self.__closed:
+        if self.__closed and self.__closed_error_message is not None:
             raise ClientClosed(self.__closed_error_message)
         return await super().__connect__()
 
+    async def _create_connection(self) -> H2Protocol:
+        if self.__use_unix_socket:
+            return await super()._create_connection()
+
+        from .proxy_support import create_proxied_connection, get_proxy_url
+
+        assert self.__target_host is not None
+        assert self.__target_port is not None
+
+        ssl_context = self.__ssl_context
+        proxy_url = get_proxy_url(self.__target_host, use_ssl=ssl_context is not None)
+        if proxy_url is None:
+            return await super()._create_connection()
+
+        protocol = await create_proxied_connection(
+            self._protocol_factory,
+            self.__target_host,
+            self.__target_port,
+            proxy_url=proxy_url,
+            ssl_context=ssl_context,
+        )
+        return protocol
+
     def close(self):
         self.__closed = True
         return super().close()
@@ -116,7 +190,10 @@ class ConnectionManager:
 
     async def get_or_create_channel(self, server_url: str) -> grpclib.client.Channel:
         if server_url not in self._channels:
-            self._channels[server_url] = create_channel(server_url, self._metadata)
+            self._channels[server_url] = create_channel(
+                server_url,
+                self._metadata,
+            )
             try:
                 await connect_channel(self._channels[server_url])
             except (OSError, asyncio.TimeoutError) as exc:
@@ -207,7 +284,7 @@ def create_channel(
         ssl = o.scheme.endswith("s")
         host = parts[0]
         port = int(parts[1]) if len(parts) == 2 else 443 if ssl else 80
-        channel = grpclib.client.Channel(host, port, ssl=ssl, config=config, status_details_codec=custom_detail_codec)
+        channel = ModalChannel(host, port, ssl=ssl, config=config, status_details_codec=custom_detail_codec)
     else:
         raise Exception(f"Unknown scheme: {o.scheme}")
 

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/_utils/http_utils.py

@@ -27,8 +27,27 @@ def _http_client_with_tls(timeout: float | None) -> "ClientSession":
     import certifi
     from aiohttp import ClientSession, ClientTimeout, TCPConnector
 
+    from .proxy_support import get_proxy_url
+
     ssl_context = ssl.create_default_context(cafile=certifi.where())
-    connector = TCPConnector(ssl=ssl_context)
+
+    connector: TCPConnector
+    proxy_url = get_proxy_url(None, use_ssl=True)
+    if proxy_url:
+        try:
+            from aiohttp_socks import ProxyConnector
+        except ImportError:
+            raise ImportError(
+                f"A proxy is configured ({proxy_url}) but the 'aiohttp-socks' package "
+                "is not installed. Install it with: pip install 'modal[api-proxy-support]'"
+            ) from None
+        from .proxy_support import _normalize_proxy_url
+
+        normalized_url, rdns = _normalize_proxy_url(proxy_url)
+        connector = ProxyConnector.from_url(normalized_url, rdns=rdns, ssl=ssl_context)
+    else:
+        connector = TCPConnector(ssl=ssl_context)
+
     return ClientSession(connector=connector, timeout=ClientTimeout(total=timeout))
 
 

modal-1.5.1.dev14/modal/_utils/proxy_support.py

@@ -0,0 +1,102 @@
+# Copyright Modal Labs 2026
+"""Proxy support for gRPC (grpclib) and HTTP (aiohttp) connections.
+
+By default, the Modal client reads standard proxy environment variables
+(HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY and their lowercase
+variants).  Set ``MODAL_DISABLE_API_PROXY=1`` to opt out.
+
+Supported proxy types:
+- HTTP CONNECT (``http://host:port``)
+- SOCKS4/4a/5/5h (``socks5://``, ``socks5h://``, etc.)
+
+All proxy types require the optional ``python-socks[asyncio]`` package.
+Install it via ``pip install modal[api-proxy-support]``.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import ssl
+import urllib.parse
+import urllib.request
+
+from grpclib.protocol import H2Protocol
+
+
+def get_proxy_url(host: str | None, *, use_ssl: bool) -> str | None:
+    """Return the proxy URL for the given target, respecting NO_PROXY when host is known."""
+    from ..config import config
+
+    if config.get("disable_api_proxy"):
+        return None
+
+    if host is not None and urllib.request.proxy_bypass(host):
+        return None
+
+    proxies = urllib.request.getproxies()
+    if not proxies:
+        return None
+
+    scheme = "https" if use_ssl else "http"
+    proxy_url = proxies.get(scheme) or proxies.get("all")
+    return proxy_url or None
+
+
+def _normalize_proxy_url(proxy_url: str) -> tuple[str, bool]:
+    """Normalize a proxy URL for python-socks, which doesn't handle socks5h/socks4a.
+
+    Returns (normalized_url, rdns) where rdns=True for remote-DNS schemes.
+    """
+    parsed = urllib.parse.urlparse(proxy_url)
+    scheme = parsed.scheme.lower()
+    if scheme == "socks5h":
+        return urllib.parse.urlunparse(
+            ("socks5", parsed.netloc, parsed.path, parsed.params, parsed.query, parsed.fragment)
+        ), True
+    elif scheme == "socks4a":
+        return urllib.parse.urlunparse(
+            ("socks4", parsed.netloc, parsed.path, parsed.params, parsed.query, parsed.fragment)
+        ), True
+    return proxy_url, False
+
+
+async def create_proxied_connection(
+    protocol_factory,
+    host: str,
+    port: int,
+    *,
+    proxy_url: str,
+    ssl_context: ssl.SSLContext | None = None,
+) -> H2Protocol:
+    """Create a gRPC connection through the configured proxy."""
+
+    try:
+        from python_socks.async_.asyncio import Proxy
+    except ImportError:
+        raise ImportError(
+            f"A proxy is configured ({proxy_url}) but the 'python-socks' package is not installed. "
+            "Install it with: pip install 'modal[api-proxy-support]'"
+        ) from None
+
+    normalized_url, rdns = _normalize_proxy_url(proxy_url)
+    proxy = Proxy.from_url(normalized_url, rdns=rdns)
+    sock = await proxy.connect(host, port)
+
+    loop = asyncio.get_running_loop()
+    try:
+        if ssl_context:
+            _, protocol = await loop.create_connection(
+                protocol_factory,
+                sock=sock,
+                ssl=ssl_context,
+                server_hostname=host,
+            )
+        else:
+            _, protocol = await loop.create_connection(
+                protocol_factory,
+                sock=sock,
+            )
+    except BaseException:
+        sock.close()
+        raise
+    return protocol

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/_utils/task_command_router_client.py

@@ -23,7 +23,7 @@ from modal_proto import api_pb2, task_command_router_pb2 as sr_pb2
 from modal_proto.task_command_router_grpc import TaskCommandRouterStub
 
 from .._grpc_client import grpc_error_converter
-from .._utils.grpc_utils import PermanentCloseableChannel
+from .._utils.grpc_utils import ModalChannel
 from .async_utils import aclosing, retry
 from .grpc_utils import RETRYABLE_GRPC_STATUS_CODES
 
@@ -218,7 +218,7 @@ class TaskCommandRouterClient:
         host, _, port_str = o.netloc.partition(":")
         port = int(port_str) if port_str else (443 if o.scheme == "https" else 80)
 
-        channel = PermanentCloseableChannel(
+        channel = ModalChannel(
             host,
             port,
             ssl=ssl_context,

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/app.py

@@ -1284,21 +1284,21 @@ class _App:
         cpu: float | tuple[float, float] | None = None,  # CPU cores to request
         memory: int | tuple[int, int] | None = None,  # Memory in MiB to request
         ephemeral_disk: int | None = None,  # Ephemeral disk size in MiB
+        target_concurrency: int | None = None,  # Target concurrency for the server; 0 disables autoscaling
         min_containers: int | None = None,  # Minimum number of containers to keep warm
         max_containers: int | None = None,  # Maximum number of containers
         buffer_containers: int | None = None,  # Additional idle containers under active load
         scaleup_window: int | None = None,  # Stabilization window (seconds) of sustained demand before scaling up
         scaledown_window: int | None = None,  # Max idle time before scaling down (seconds)
         proxy: _Proxy | None = None,  # Modal Proxy to use in front of this server
-        unauthenticated: bool = False,  # Whether the endpoint requires proxy authentication, required by default.
         port: int = 8000,  # Port the HTTP server listens on
+        unauthenticated: bool = False,  # Whether the endpoint requires proxy authentication, required by default.
+        h2_enabled: bool = False,  # Enable HTTP/2
         startup_timeout: int = 30,  # Maximum startup time in seconds
         exit_grace_period: int = 0,  # Grace period for in-flight requests on shutdown
         routing_region: str = "us-east",  # Region to route Server requests through
-        h2_enabled: bool = False,  # Enable HTTP/2
-        target_concurrency: int | None = None,  # Target concurrency for the server; 0 disables autoscaling
+        compute_region: str | Sequence[str] | None = None,  # Region(s) where containers can be scheduled
         cloud: str | None = None,  # Cloud provider (aws, gcp, oci, auto)
-        region: str | Sequence[str] | None = None,  # Region(s) to run on
         nonpreemptible: bool = False,  # Whether to use non-preemptible instances
         enable_memory_snapshot: bool = False,  # Enable memory checkpointing
         i6pn: bool | None = None,  # Enable IPv6 container networking
@@ -1328,6 +1328,7 @@ class _App:
                 Specify, in MiB, a memory request which is the minimum memory required. Or, pass (request, limit) to
                 additionally specify a hard limit in MiB.
             ephemeral_disk: Specify, in MiB, the ephemeral disk size for the server.
+            target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             min_containers: Minimum number of containers to keep warm.
             max_containers: Maximum number of containers.
             buffer_containers: Additional idle containers under active load.
@@ -1336,13 +1337,12 @@ class _App:
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
             unauthenticated: Whether the endpoint requires proxy authentication, required by default.
+            h2_enabled: Enable HTTP/2.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2.
-            target_concurrency: Target concurrency for the server; 0 disables autoscaling.
+            compute_region: Region(s) where containers can be scheduled.
             cloud: Cloud provider (aws, gcp, oci, auto).
-            region: Region(s) to run on.
             nonpreemptible: Whether to use non-preemptible instances.
             enable_memory_snapshot: Enable memory checkpointing.
             i6pn: Enable IPv6 container networking.
@@ -1441,7 +1441,7 @@ class _App:
                 batch_wait_ms=None,  # No support for Server level batching
                 startup_timeout=startup_timeout,
                 cloud=cloud,
-                region=region,
+                region=compute_region,
                 nonpreemptible=nonpreemptible,
                 enable_memory_snapshot=enable_memory_snapshot,
                 single_use_containers=False,  # No support for single-use server containers

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/app.pyi

@@ -745,21 +745,21 @@ class _App:
         cpu: typing.Union[float, tuple[float, float], None] = None,
         memory: typing.Union[int, tuple[int, int], None] = None,
         ephemeral_disk: typing.Optional[int] = None,
+        target_concurrency: typing.Optional[int] = None,
         min_containers: typing.Optional[int] = None,
         max_containers: typing.Optional[int] = None,
         buffer_containers: typing.Optional[int] = None,
         scaleup_window: typing.Optional[int] = None,
         scaledown_window: typing.Optional[int] = None,
         proxy: typing.Optional[modal.proxy._Proxy] = None,
-        unauthenticated: bool = False,
         port: int = 8000,
+        unauthenticated: bool = False,
+        h2_enabled: bool = False,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
         routing_region: str = "us-east",
-        h2_enabled: bool = False,
-        target_concurrency: typing.Optional[int] = None,
+        compute_region: typing.Union[str, collections.abc.Sequence[str], None] = None,
         cloud: typing.Optional[str] = None,
-        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
         nonpreemptible: bool = False,
         enable_memory_snapshot: bool = False,
         i6pn: typing.Optional[bool] = None,
@@ -789,6 +789,7 @@ class _App:
                 Specify, in MiB, a memory request which is the minimum memory required. Or, pass (request, limit) to
                 additionally specify a hard limit in MiB.
             ephemeral_disk: Specify, in MiB, the ephemeral disk size for the server.
+            target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             min_containers: Minimum number of containers to keep warm.
             max_containers: Maximum number of containers.
             buffer_containers: Additional idle containers under active load.
@@ -797,13 +798,12 @@ class _App:
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
             unauthenticated: Whether the endpoint requires proxy authentication, required by default.
+            h2_enabled: Enable HTTP/2.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2.
-            target_concurrency: Target concurrency for the server; 0 disables autoscaling.
+            compute_region: Region(s) where containers can be scheduled.
             cloud: Cloud provider (aws, gcp, oci, auto).
-            region: Region(s) to run on.
             nonpreemptible: Whether to use non-preemptible instances.
             enable_memory_snapshot: Enable memory checkpointing.
             i6pn: Enable IPv6 container networking.
@@ -1748,21 +1748,21 @@ class App:
         cpu: typing.Union[float, tuple[float, float], None] = None,
         memory: typing.Union[int, tuple[int, int], None] = None,
         ephemeral_disk: typing.Optional[int] = None,
+        target_concurrency: typing.Optional[int] = None,
         min_containers: typing.Optional[int] = None,
         max_containers: typing.Optional[int] = None,
         buffer_containers: typing.Optional[int] = None,
         scaleup_window: typing.Optional[int] = None,
         scaledown_window: typing.Optional[int] = None,
         proxy: typing.Optional[modal.proxy.Proxy] = None,
-        unauthenticated: bool = False,
         port: int = 8000,
+        unauthenticated: bool = False,
+        h2_enabled: bool = False,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
         routing_region: str = "us-east",
-        h2_enabled: bool = False,
-        target_concurrency: typing.Optional[int] = None,
+        compute_region: typing.Union[str, collections.abc.Sequence[str], None] = None,
         cloud: typing.Optional[str] = None,
-        region: typing.Union[str, collections.abc.Sequence[str], None] = None,
         nonpreemptible: bool = False,
         enable_memory_snapshot: bool = False,
         i6pn: typing.Optional[bool] = None,
@@ -1790,6 +1790,7 @@ class App:
                 Specify, in MiB, a memory request which is the minimum memory required. Or, pass (request, limit) to
                 additionally specify a hard limit in MiB.
             ephemeral_disk: Specify, in MiB, the ephemeral disk size for the server.
+            target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             min_containers: Minimum number of containers to keep warm.
             max_containers: Maximum number of containers.
             buffer_containers: Additional idle containers under active load.
@@ -1798,13 +1799,12 @@ class App:
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
             unauthenticated: Whether the endpoint requires proxy authentication, required by default.
+            h2_enabled: Enable HTTP/2.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2.
-            target_concurrency: Target concurrency for the server; 0 disables autoscaling.
+            compute_region: Region(s) where containers can be scheduled.
             cloud: Cloud provider (aws, gcp, oci, auto).
-            region: Region(s) to run on.
             nonpreemptible: Whether to use non-preemptible instances.
             enable_memory_snapshot: Enable memory checkpointing.
             i6pn: Enable IPv6 container networking.

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/client.pyi

@@ -35,7 +35,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.1.dev12",
+        version: str = "1.5.1.dev14",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -205,7 +205,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.5.1.dev12",
+        version: str = "1.5.1.dev14",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal/config.py

@@ -302,6 +302,7 @@ _SETTINGS = {
     "dev_suffix": _Setting("", transform=_enforce_suffix_rules),
     "max_throttle_wait": _Setting(None, transform=lambda x: int(x) if x else None),
     "async_warnings": _Setting(True, transform=_to_boolean),  # Activate synchronicity usage warnings
+    "disable_api_proxy": _Setting(False, transform=_to_boolean),
 }
 
 

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.5.1.dev12
+Version: 1.5.1.dev14
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0
@@ -29,6 +29,9 @@ Requires-Dist: types-certifi
 Requires-Dist: types-toml
 Requires-Dist: watchfiles
 Requires-Dist: typing_extensions~=4.6
+Provides-Extra: api-proxy-support
+Requires-Dist: python-socks[asyncio]>=2.5; extra == "api-proxy-support"
+Requires-Dist: aiohttp-socks>=0.8; extra == "api-proxy-support"
 Dynamic: license-file
 
 # Modal Python SDK

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal.egg-info/SOURCES.txt

@@ -141,6 +141,7 @@ modal/_utils/mount_utils.py
 modal/_utils/name_utils.py
 modal/_utils/package_utils.py
 modal/_utils/pattern_utils.py
+modal/_utils/proxy_support.py
 modal/_utils/rand_pb_testing.py
 modal/_utils/sandbox_fs_utils.py
 modal/_utils/shell_utils.py

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal.egg-info/requires.txt

@@ -16,3 +16,7 @@ grpclib<0.4.10,>=0.4.7
 
 [:python_version >= "3.14"]
 grpclib<0.4.10,>=0.4.9
+
+[api-proxy-support]
+python-socks[asyncio]>=2.5
+aiohttp-socks>=0.8

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.5.1.dev12"
+__version__ = "1.5.1.dev14"

{modal-1.5.1.dev12 → modal-1.5.1.dev14}/pyproject.toml

@@ -34,6 +34,9 @@ classifiers = [
     "Programming Language :: Python :: 3",
 ]
 
+[project.optional-dependencies]
+api-proxy-support = ["python-socks[asyncio]>=2.5", "aiohttp-socks>=0.8"]
+
 [dependency-groups]
 dev = [
     "fastapi~=0.125",
@@ -91,6 +94,8 @@ dev = [
     # this pip package to load zone keys like ``America/New_York``. Tiny and
     # harmless on other platforms.
     "tzdata",
+    "python-socks[asyncio]>=2.5",
+    "aiohttp-socks>=0.8",
 ]
 
 [tool.uv.extra-build-dependencies]