icefold-sdk
The slim, shared kernel for IceFold: the worker-control WebSocket protocol
plus a small on-runner helper kit. It ships no node implementations — the
server renders each node into a self-contained .py bundle and the
icefold-runner imports the bundle
on demand.
Import name: the distribution is
icefold-sdk, but it installs as the top-level packageicefold(likepyyaml→import yaml).
import icefold
print(icefold.__version__)
Both the IceFold server and the runner depend on this package: the server uses the wire / id / log surface to talk to its workers; the runner uses the same wire protocol to dial back, then imports server-rendered bundles to run jobs.
Surface
| Module | What |
|---|---|
icefold.wire |
/v1/ws/worker frames: make_node_exec, make_worker_ready, make_missing_dep, binary_install_hint; constants (SRV_NODE_EXEC, SRV_WORKER_READY, WKR_NODE_DONE, …); worker output endpoint constant |
icefold._logging |
Coloured stdout logger (log_info, log_warning, log_error, log_debug) |
icefold.ids |
get_file_id() — time-ordered unique id for output filenames |
icefold.config |
DATA_DIR / SCRATCH_BASE_DIR (driven by ICEFOLD_PROJECT_ROOT) |
icefold.exceptions |
AppError family + MissingDependencyError |
icefold.runtime |
run_blocking(fn, *a, **kw) + write_text(path, content) — off-event-loop IO helpers |
icefold.__init__ |
Slim re-export: log_* / get_file_id / run_blocking / write_text |
Install
pip install icefold-sdk # runner-side helpers + wire protocol
Requires Python ≥ 3.11. This package is the shared protocol layer; if you want
to run IceFold nodes on your own machine, install
icefold-runner instead (it pulls
this in).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file icefold_sdk-0.1.6.tar.gz.
File metadata
- Download URL: icefold_sdk-0.1.6.tar.gz
- Upload date:
- Size: 13.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ceca191b3bedb805ce6e43891503c8975ad42ee2f39644bf27c6c481810da46
|
|
| MD5 |
3873fd1b983c23121b3d6cc70c88afb9
|
|
| BLAKE2b-256 |
40abf04b94de43a48c9a2c2205bac621e94ff911c8a96628008026e507a7978f
|
File details
Details for the file icefold_sdk-0.1.6-py3-none-any.whl.
File metadata
- Download URL: icefold_sdk-0.1.6-py3-none-any.whl
- Upload date:
- Size: 14.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e627319ac8fbbd2ea7f508fd37e3e1a2217ee4d8c2c516e594d94e59dd304a2b
|
|
| MD5 |
fcd899f4e0195f60036e7cafa8b6e0c4
|
|
| BLAKE2b-256 |
d4051646ed31dc6687c06fd43a74abc0ef6d21250467d3752956630c97def25b
|
