whispy-client 1.1.5

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

For local development from this repo:

cd client
pip install -e .

API

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

package can be a bare PyPI distribution name or an exact pin such as requests==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, optionally with ==version
module	Import name if different from the package name
version	Explicit version override, if you do not want to embed it 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.