whispy-client 1.1.6

Stream Python packages at runtime — the PyPI CDN client

🌀 Whispy Client

Import Python packages at runtime with a zero-dependency client. Keep your scripts clean, your environments disposable, and your setup friction low.

The client lives in the Whispy repository, with the implementation in client/whispy_client and the server entrypoint in server/app.py. It downloads a bundle from a Whispy server, extracts it to a temporary directory, and imports the requested module at runtime.

When to Use It

• Throwaway scripts that need requests, numpy, or beautifulsoup4 without a setup step.
• Short-lived jobs where you want packages to vanish when the process exits.
• Pinned runtime experiments where one exact version matters.
• Self-hosted setups that point at your own server from the main repo.

Quick Examples

from whispy_client import remote, configure

configure(verbose=True)

requests = remote("requests")
numpy = remote("numpy", version="1.26.4")
bs4 = remote("beautifulsoup4", module="bs4", deps=True)

# Version pinning (use the version parameter)
requests = remote("requests", version="2.31.0")
numpy = remote("numpy", version="1.26.4")

# Common import name mismatches
bs4 = remote("beautifulsoup4", module="bs4")
PIL = remote("pillow", module="PIL")
yaml = remote("pyyaml", module="yaml")
dateutil = remote("python-dateutil", module="dateutil")
cv2 = remote("opencv-python", module="cv2", deps=True)

Import Failure Tips

If a package downloads but import fails with an error like No module named 'numpy', that usually means a dependency is missing from the runtime bundle.

• Retry with deps=True for that call.
• Or set configure(deps=True) once for process-wide behavior.
• Keep module="..." when the import name differs from the distribution name.

Example:

# opencv-python imports as cv2 and needs runtime dependencies
cv2 = remote("opencv-python", module="cv2", deps=True)

Install

pip install whispy-client

whispy-client on PyPI

For local development from this repo:

cd client
pip install -e .

API

remote(package, *, module=None, version=None, deps=False, host=None)

package is a PyPI distribution name. Specify versions using the version parameter (for example: remote("requests", version="2.31.0")). If the import name differs from the distribution name, pass module=....

deps=True asks the server to include install-time dependencies as well. That behavior is best-effort and does not perform full dependency conflict resolution.

Param	Description
package	PyPI distribution name
module	Import name if different from the package name
version	Explicit version override. Specify versions here instead of embedding them in package
deps	Fetch install-time dependencies as well
host	Per-call Whispy server override

configure(*, host=None, deps=None, verbose=None)

Sets process-wide defaults. The default host comes from WHISPY_HOST, falling back to https://cdn.whispycdn.dev.

Param	Description
host	Default Whispy server URL
deps	Default dependency-fetching behavior
verbose	Print progress messages while fetching and importing

Code References

• The client implementation is in client/whispy_client/core.py.
• The server path that resolves bundles is in server/app.py.
• The release workflow is in the repo workflow file.

License

MIT. Packages are sourced from PyPI and remain under their original licenses.