kubetorch 0.2.0__py3-none-any.whl

kubetorch-0.2.0.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: kubetorch
+Version: 0.2.0
+Summary: Kubetorch: A Kubernetes-native framework for distributed PyTorch workloads
+License: Apache 2.0
+Author: Runhouse Team
+Requires-Python: >=3.9,<=3.13
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Provides-Extra: client
+Provides-Extra: docs
+Provides-Extra: otel
+Provides-Extra: server
+Requires-Dist: fastapi ; extra == "server"
+Requires-Dist: httpx (>=0.28.0,<0.29.0)
+Requires-Dist: jinja2 (>=3.0)
+Requires-Dist: kubernetes (>=20.0.0,!=32.0.0)
+Requires-Dist: myst-parser ; extra == "docs"
+Requires-Dist: opentelemetry-api ; extra == "otel"
+Requires-Dist: opentelemetry-distro ; extra == "otel"
+Requires-Dist: opentelemetry-exporter-otlp ; extra == "otel"
+Requires-Dist: opentelemetry-exporter-prometheus ; extra == "otel"
+Requires-Dist: opentelemetry-instrumentation ; extra == "otel"
+Requires-Dist: opentelemetry-instrumentation-fastapi ; extra == "otel"
+Requires-Dist: opentelemetry-instrumentation-logging ; extra == "otel"
+Requires-Dist: opentelemetry-instrumentation-requests ; extra == "otel"
+Requires-Dist: opentelemetry-sdk ; extra == "otel"
+Requires-Dist: prometheus-api-client ; extra == "client"
+Requires-Dist: prometheus-client ; extra == "otel"
+Requires-Dist: pydantic (>=2.5.0)
+Requires-Dist: python-json-logger ; extra == "server"
+Requires-Dist: pyyaml (>=6.0,<7.0)
+Requires-Dist: requests (>=2.32.0,<3.0.0)
+Requires-Dist: rich ; extra == "client"
+Requires-Dist: sphinx ; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints ; extra == "docs"
+Requires-Dist: sphinx-book-theme ; extra == "docs"
+Requires-Dist: typer ; extra == "client"
+Requires-Dist: uvicorn[standard] ; extra == "server"
+Requires-Dist: web-pdb ; extra == "server"
+Requires-Dist: websockets (>=15.0,<16.0)
+Project-URL: Documentation, https://www.run.house/kubetorch/introduction
+Project-URL: Homepage, https://run.house
+Project-URL: Repository, https://github.com/run-house/kubetorch
+Description-Content-Type: text/markdown
+
+# 📦Kubetorch🔥
+
+**A Python interface for running ML workloads on Kubernetes**
+
+Kubetorch enables you to run any Python code on Kubernetes at any scale by specifying required resources, distribution, and scaling directly in code. It provides caching and hot redeployment for 1-2 second iteration cycles, handles hardware faults and preemptions programmatically, and orchestrates complex, heterogeneous workloads with built-in observability and fault tolerance.
+
+## Hello World
+
+```python
+from kubetorch import fn
+
+def hello_world():
+    return "Hello from Kubetorch!"
+
+if __name__ == "__main__":
+    # Define your compute
+    compute = kt.Compute(cpus=".1")
+
+    # Send local function to freshly launched remote compute
+    remote_hello = kt.fn(hello_world).to(compute)
+
+    # Runs remotely on your Kubernetes cluster
+    result = hello_world()
+    print(result)  # "Hello from Kubetorch!"
+```
+
+## What Kubetorch Enables
+
+- **100x faster iteration** from 10+ minutes to 1-3 seconds for complex ML applications like RL and distributed training
+- **50%+ compute cost savings** through intelligent resource allocation, bin-packing, and dynamic scaling
+- **95% fewer production faults** with built-in fault handling with programmatic error recovery and resource adjustment
+
+## Installation
+
+### 1. Python Client
+
+```bash
+pip install "kubetorch[client]"
+```
+
+### 2. Kubernetes Deployment (Helm)
+
+```bash
+# Option 1: Install directly from OCI registry
+helm upgrade --install kubetorch oci://ghcr.io/run-house/charts/kubetorch \
+  --version 0.2.0 -n kubetorch --create-namespace
+
+# Option 2: Download chart locally first
+helm pull oci://ghcr.io/run-house/charts/kubetorch --version 0.2.0 --untar
+helm upgrade --install kubetorch ./kubetorch -n kubetorch --create-namespace
+```
+
+For detailed setup instructions, see our [Installation Guide](https://www.run.house/kubetorch/installation).
+
+
+## Learn More
+
+- **[Documentation](https://www.run.house/kubetorch/introduction)** - API Reference, concepts, and guides
+- **[Examples](https://www.run.house/kubetorch/examples)** - Real-world usage patterns and tutorials
+- **[Join our Slack](https://join.slack.com/t/kubetorch/shared_invite/zt-3g76q5i4j-uP60AdydxnAmjGVAQhtALA)** - Connect with the community and get support
+
+---
+
+[Apache 2.0 License](LICENSE)
+
+**🏃‍♀️ Built by [Runhouse](https://www.run.house) 🏠**
+

kubetorch-0.2.0.dist-info/RECORD

@@ -0,0 +1,93 @@
+kubetorch/__init__.py,sha256=EwSzER4seuElVH9dpIu9k09dHfvnfBx1dp_zu-0B4h0,2115
+kubetorch/cli.py,sha256=yCn-1z71TNS-tvA2D5CbZF3YTh2QYvfyXi7H3yN2vXI,68611
+kubetorch/cli_utils.py,sha256=zzABvAT35eQulAakAmo6PwZkMg6pZNLA3HoZqsYZQB0,33353
+kubetorch/config.py,sha256=-up9Tljkls_ZU8bASjDRnFaxTknBsoLeWgbuXbSt6cw,15839
+kubetorch/constants.py,sha256=ReN2Gc7c5nMncR2cXiy5MzXZagF7D4yDHlBgNmwBJfc,401
+kubetorch/docs/Makefile,sha256=ViKZxIiAhmNzDK14SzAubiaIrrEUA_rTxWxy8SZxywk,479
+kubetorch/docs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/docs/_ext/json_globaltoc.py,sha256=LAX_EKskCdUI9bmAnCXfdyRTViwX1NulUXu_kATyKL4,1582
+kubetorch/docs/api/cli.rst,sha256=_V2WVVODbbdcopWx-BLJkHiO_1BrBb9tKKvl4BTgrHw,400
+kubetorch/docs/api/python/app.rst,sha256=TYXLcYbCEqVW7l1VQ9NVFcCl73tuJ9oPMAMcQ_sLzk4,492
+kubetorch/docs/api/python/cls.rst,sha256=h5tjCqtyQNWtmBOaH5ERGS1nxp0Selm1fbsIMcnO-H8,398
+kubetorch/docs/api/python/compute.rst,sha256=UyFehzcpMU4DszdSJna1w2Bq-ODWmK2Y9YmA6pDld2w,437
+kubetorch/docs/api/python/config.rst,sha256=3-qphQwOo9lFK4balsmYD2t4hnPAVlZ72ASpu6mUxtI,278
+kubetorch/docs/api/python/fn.rst,sha256=8IC4o2Acc4yP-HYGrRkNZcAgrQbnepyv77MAANV-ecQ,396
+kubetorch/docs/api/python/image.rst,sha256=D_VKiEIr56ZUyxQR8SG2lRqq6JQYsYs_259_kyVQNak,314
+kubetorch/docs/api/python/secret.rst,sha256=C6IdKjg2-p86zDzRPOTkYxScLs1D3zXrtQYh5Bnh9B4,339
+kubetorch/docs/api/python/volumes.rst,sha256=D2DZUsjrH4rNB1a0tRV-t8P2HcHe4bG6DAMKKncab6g,330
+kubetorch/docs/api/python.rst,sha256=cnqqGeEFASyJt0A--c9yAzadusgbPJWZP7SeQL6MeAM,2997
+kubetorch/docs/conf.py,sha256=P7ZQWnIQYCn2aqXLeMlc6mG4aTzxXwcqqYwHm02ZCUI,1954
+kubetorch/docs/index.rst,sha256=DAoVC-1NJQUStUlbq446cb1Iy_ae1CqdBIXUbC6mlYk,578
+kubetorch/docs/requirements.txt,sha256=-NDXLpwXyEHQuep9rebi9OdjkRoewrGouhaccZDph4A,128
+kubetorch/globals.py,sha256=Kv_8Qvnry0-eTgrlvdWUlId5yuJZYEwVBYD9Z6CpDB4,9411
+kubetorch/logger.py,sha256=uLcpdozhAVGV88_kiop6qI9mOFmCpZ8xJ5SyilHhYuw,1628
+kubetorch/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/resources/callables/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/resources/callables/cls/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/resources/callables/cls/cls.py,sha256=WNIum_Fr0oBY9aK149WCPv4cdIBhZp19VUFI7L9RJaM,5695
+kubetorch/resources/callables/fn/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/resources/callables/fn/fn.py,sha256=1GO4zuXAS3NebkH_AymVyA-_lYSIIRox__0N6UhpQog,4741
+kubetorch/resources/callables/module.py,sha256=y2aAKCJlMoB7IHbEvm2DrlejYDsoTO2SMSJzMB5IQ-0,56022
+kubetorch/resources/callables/utils.py,sha256=kqGRQeRKtn64rv2mLCmcixsGu2QtEeUVyOe7dpPrHo0,6381
+kubetorch/resources/compute/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/resources/compute/app.py,sha256=XkCxN-ZcdeZDDZ545LZ_e0tJ3o6c4-lUWiddnc_IwiQ,8598
+kubetorch/resources/compute/compute.py,sha256=iIbymAnsXdgEramZ4Eqwy2GFsQ52bZRmu49IRNWvyEQ,101902
+kubetorch/resources/compute/decorators.py,sha256=dAFzv7SBJodGosSXBiuzfralK9igkSRubrreD4KEyo8,4844
+kubetorch/resources/compute/rbac.py,sha256=3qovND0Vmivi4qthiABqEqSjJBoNx3tpVkul_briiiE,2444
+kubetorch/resources/compute/utils.py,sha256=zZnXOSWOOlgAxxs4YXFFYt5Ow_VCi5mBkfH8Ixq4U-4,38164
+kubetorch/resources/compute/websocket.py,sha256=mDT05-2OROdRaYWEXZzRYrvnxVYiwdEcwLgVuHqDiGE,4562
+kubetorch/resources/images/__init__.py,sha256=JyEkhdAaBLjjO1iUkdKIZFBTTC-XpZ2z-Livr_cUUDM,36
+kubetorch/resources/images/image.py,sha256=azwYDAFBtRh9_RVYWNKjCsn85tcy_xmY18siEhzcc1M,16360
+kubetorch/resources/images/images.py,sha256=m3Yngg4Pl2MtZf2Ge9c2-Fn9DFjkSXP8KqKklue_LV0,2119
+kubetorch/resources/secrets/__init__.py,sha256=bAcntNq4IVdbgfL-NiUSMCJzskAvhuzD5tTUuXa75q4,90
+kubetorch/resources/secrets/kubernetes_secrets_client.py,sha256=7g8RhnoGhpxDIUSNoQSzEMHXVM1J6icE4q7fufwq_O8,15658
+kubetorch/resources/secrets/provider_secrets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/resources/secrets/provider_secrets/anthropic_secret.py,sha256=_vGgkTNFZIlIuMyD5TF_yIEaSFr2cGsH76_fLTD-O7E,301
+kubetorch/resources/secrets/provider_secrets/aws_secret.py,sha256=UY8R_r-NvwTUTl_6_jLwKz6A_2nOACwueFK2cj0X99g,410
+kubetorch/resources/secrets/provider_secrets/azure_secret.py,sha256=VEn8DLThps2GYF2W6C0xtn6qNnCS4S6aFmdVwkTY7W0,417
+kubetorch/resources/secrets/provider_secrets/cohere_secret.py,sha256=XdztDQLSZKQf9r76V_h9IJPCGl5Y3DdJJVObvByp9hk,286
+kubetorch/resources/secrets/provider_secrets/gcp_secret.py,sha256=JsdAGspPDOtsuWv1-_SIsFvxc7x0saz97xNBVNuV2JQ,420
+kubetorch/resources/secrets/provider_secrets/github_secret.py,sha256=ZqGBn4_YFBdhOG2qa2VSJFn3wEeaka8mbfRvOrDOt-Q,342
+kubetorch/resources/secrets/provider_secrets/huggingface_secret.py,sha256=2E8JIohrzJJaLW1p5Mm2yv-Dpb4iqS93CmTQGn86H9k,536
+kubetorch/resources/secrets/provider_secrets/kubeconfig_secret.py,sha256=4d8OB429AX2tdDhEvswHE-tuEAf4dj4XptYBTkkUxCU,298
+kubetorch/resources/secrets/provider_secrets/lambda_secret.py,sha256=0WQQy8c6Dhxk8APT1RMXOskak2j-5hDsQjN7vn3fAkE,340
+kubetorch/resources/secrets/provider_secrets/langchain_secret.py,sha256=uhjO8X9WKxhfzVa3Y2lQxNd-rAqYsArE7ErXAj9A6Hg,301
+kubetorch/resources/secrets/provider_secrets/openai_secret.py,sha256=rqlO2IQUmdQ7MkqHbqCWoWVsodxjyA4A_B97qNv8Pf4,274
+kubetorch/resources/secrets/provider_secrets/pinecone_secret.py,sha256=HeXyVUkS5wB-rIouDsQNP2kYJcaH0qkz06SGFg13kSA,296
+kubetorch/resources/secrets/provider_secrets/providers.py,sha256=YZFgREkmeMTu9ueDjs3xZUdxpOzTmWx5bc0CjR-7joM,3175
+kubetorch/resources/secrets/provider_secrets/ssh_secret.py,sha256=rZjuiEhZ7isg9ZfgkIg9frBqY4DUEZBMjwE0hv7pYxI,272
+kubetorch/resources/secrets/provider_secrets/wandb_secret.py,sha256=eVfCtMejPb7fvt5Yz1PJV7oXRBrkt-ialj3fo_5nOjI,269
+kubetorch/resources/secrets/secret.py,sha256=8Xbd7syeVca5DnsNDh97D4JdPZthrbSg5GM6G4c1hEo,9385
+kubetorch/resources/secrets/secret_factory.py,sha256=IG8WZAAWf4f8zJTX_JFU88nTLo3P3lDl1efdudkf08s,2950
+kubetorch/resources/secrets/utils.py,sha256=Bf65Dwuun1KY6J02AdfpEXXR9qrBskxyyAkpXPF9DhU,6993
+kubetorch/resources/volumes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/resources/volumes/volume.py,sha256=SnjH8x94oyOZO13mYVCkL-fJY6QuLPbLAC5rS24o8Lc,12200
+kubetorch/servers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/servers/http/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/servers/http/distributed_utils.py,sha256=6CLZn4JOdTIWSvnN5DYOIhiT7NctFeEtL-nqOAx4bYM,129685
+kubetorch/servers/http/http_client.py,sha256=xs84zNGnquiF_q3FNcdGEKXu9LLmrnKxeJcAlZzP27I,29753
+kubetorch/servers/http/http_server.py,sha256=CscBJBd7GiHxuWTopvK0JKFqqy7fyjM_aLUVEGVCJ30,69822
+kubetorch/servers/http/server_metrics.py,sha256=0c9K7DBo6fYXAYqCXf2zqDyARP7mB2fwPOuDTzVTIQk,9614
+kubetorch/servers/http/utils.py,sha256=39MQDD027D5YwA78U_hBVjbSvEsymYwZ-SVvQ4Zpzk8,27231
+kubetorch/serving/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kubetorch/serving/autoscaling.py,sha256=u6Ex4FyuQr4ZXIPKM0cYa3RkHxPVGp5STKPwdKJB44E,6516
+kubetorch/serving/base_service_manager.py,sha256=pjjMmDCVj60P1XUS6muxHDXB_B5CRzRnOMBSPAybCyc,13481
+kubetorch/serving/constants.py,sha256=RFi-czWgxqGfTfviPWOvhotsB1t-_mEkb65aR8Orvlo,2571
+kubetorch/serving/deployment_service_manager.py,sha256=WquYS7EOIXQP2wok0-ioUZ0OyF5xjfSfXcxzUYBgL24,18195
+kubetorch/serving/knative_service_manager.py,sha256=72JbW1r0MtDi8w5pAjCEuHs9tPeu53Lzpo_lus-N-6U,20307
+kubetorch/serving/raycluster_service_manager.py,sha256=k3u01KDsi8tW_NWzR3jytT2DAHghP3utyhAK-7FS6tU,22983
+kubetorch/serving/service_manager.py,sha256=4LdrzfwPFPf7IsSwR7HVxuSrbyBNw1dI4xPHR8TECrw,720
+kubetorch/serving/templates/deployment_template.yaml,sha256=_hPm7sXCb2BVeYuhyAGz-hRzjAoSaXNikJj_3MJfLsM,435
+kubetorch/serving/templates/knative_service_template.yaml,sha256=yKxBdduIOqDntywBdUFVaV3hc50cZhl6K91FNok6X_U,553
+kubetorch/serving/templates/kt_setup_template.sh.j2,sha256=_U5TAq7WW0ALORmKS5Ma9R8e0TUthVh3PbQi21YxryU,2680
+kubetorch/serving/templates/pod_template.yaml,sha256=5N0KuLBtphA1dyZ2hq8nYKOpaqDxUvLkZEl2fPG89yw,5530
+kubetorch/serving/templates/raycluster_service_template.yaml,sha256=kW_bIJu36Ud4kI8Q9ycnQfIIbhkxNa-C6OP93Jpl-EA,1037
+kubetorch/serving/templates/raycluster_template.yaml,sha256=ruWFk09-E85WZJc64l7NXrsdGYcW4spPzErWuzrLLes,990
+kubetorch/serving/templates/service_template.yaml,sha256=ClIMlW-JzK4I6YWo9oBbwYXgNTcz8AGDMpo8_Q8C4ng,642
+kubetorch/serving/templates/workerset_template.yaml,sha256=l7svttZrQPHDbZuZsO8EmG38eVlFUDr_UyP3E2Ci0zY,981
+kubetorch/serving/utils.py,sha256=7TASPzrK-8bX3lBvGj95I3fTp4MOBFqFhJvqA1TVvqA,12691
+kubetorch/utils.py,sha256=NIuWEWuBzOQsXb_eI5vEVYE_bu9uFzYVlyhHPQQSggo,9742
+kubetorch-0.2.0.dist-info/METADATA,sha256=IqB_-YH88RVJKCJkIDL0NFnetEDO-XxVKgm3I9HRIKI,4827
+kubetorch-0.2.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+kubetorch-0.2.0.dist-info/entry_points.txt,sha256=Gkg5B9pHJpGf-Zxk1LGx7RIG_9EI04MAbD6m4l1Rx3U,107
+kubetorch-0.2.0.dist-info/RECORD,,

kubetorch-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.1
+Root-Is-Purelib: true
+Tag: py3-none-any

kubetorch-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+kt=kubetorch.cli:app
+kt_pdb=kubetorch.servers.http.pdb:main
+kubetorch=kubetorch.cli:app
+