Phala Cloud Python SDK
Python SDK for Phala Cloud API, aligned with @phala/cloud action surface.
Goals
- Pythonic API (
snake_case, sync-first REPL experience) - Sync + Async parity
- Pydantic request/response validation
- Safe calls (
safe_*) without exceptions
Requirements
- Python >= 3.10
- uv (for development)
Installation
pip install phala-cloud
Quickstart
Sync
from phala_cloud import create_client
client = create_client(api_key="<api-key>")
me = client.get_current_user()
print(me.model_dump())
Async
import asyncio
from phala_cloud import create_async_client
async def main() -> None:
client = create_async_client(api_key="<api-key>")
me = await client.get_current_user()
print(me.model_dump())
await client.aclose()
asyncio.run(main())
Configuration
Environment variables
PHALA_CLOUD_API_KEYPHALA_CLOUD_API_PREFIX(e.g.https://cloud-api.phala.com/api/v1)
Client options
api_keybase_urlversion(2025-10-28/2026-01-21/2026-05-22)timeoutheadersuse_cookie_auth
API Style
- Direct methods: raise on HTTP/validation errors
- Safe methods (
safe_*): returnSafeResult - Function-style wrappers available in
phala_cloud.actions
Example:
result = client.safe_get_kms_list()
if result.ok:
print(result.data.items)
else:
print(result.error)
Development
cd python
# Install dependencies
uv sync
# Run tests
make test
# Lint & format
make check
E2E Test
E2E tests cover sync + async, direct + safe styles, and full interface paths.
Required:
PHALA_CLOUD_E2E_API_KEY— your Phala Cloud API key
Optional:
PHALA_CLOUD_E2E_BASE_URL— defaults tohttps://cloud-api.phala.com/api/v1
Run
cd python
PHALA_CLOUD_E2E_API_KEY="<api-key>" make e2e
Or put them in python/.env.test:
PHALA_CLOUD_E2E_API_KEY=<api-key>
# PHALA_CLOUD_E2E_BASE_URL=https://cloud-api.phala.com/api/v1
Then simply:
cd python
make e2e
License
Apache-2.0
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
phala_cloud-0.2.0.tar.gz
(144.0 kB
view details)
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 phala_cloud-0.2.0.tar.gz.
File metadata
- Download URL: phala_cloud-0.2.0.tar.gz
- Upload date:
- Size: 144.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
56e67ebe82f829500f013af246281a524151ec1fe0ed8a1fe95472ebc2feeea5
|
|
| MD5 |
6f507b8111442be9559a8776b663a0b1
|
|
| BLAKE2b-256 |
7bd160587f35219db15ae33eafaa363d1fe3d085ce1e952e09bbc2452797d2dc
|
Provenance
The following attestation bundles were made for phala_cloud-0.2.0.tar.gz:
Publisher:
release-python.yml on Phala-Network/phala-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
phala_cloud-0.2.0.tar.gz -
Subject digest:
56e67ebe82f829500f013af246281a524151ec1fe0ed8a1fe95472ebc2feeea5 - Sigstore transparency entry: 2255450109
- Sigstore integration time:
-
Permalink:
Phala-Network/phala-cloud@fec66ed5886d4e7ee078efe2a15c5ad09496d24d -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Phala-Network
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@fec66ed5886d4e7ee078efe2a15c5ad09496d24d -
Trigger Event:
issue_comment
-
Statement type:
File details
Details for the file phala_cloud-0.2.0-py3-none-any.whl.
File metadata
- Download URL: phala_cloud-0.2.0-py3-none-any.whl
- Upload date:
- Size: 37.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
957cda901b0a6e1e905865bb86ee59a36d3d3b5dc45a2c92f12cb6177f753ca3
|
|
| MD5 |
5c4feaba6a1479699249894cf1b79ae9
|
|
| BLAKE2b-256 |
0323d094d5893afafffc63884e70628760b080220fa14959468297c10a04cd88
|
Provenance
The following attestation bundles were made for phala_cloud-0.2.0-py3-none-any.whl:
Publisher:
release-python.yml on Phala-Network/phala-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
phala_cloud-0.2.0-py3-none-any.whl -
Subject digest:
957cda901b0a6e1e905865bb86ee59a36d3d3b5dc45a2c92f12cb6177f753ca3 - Sigstore transparency entry: 2255450114
- Sigstore integration time:
-
Permalink:
Phala-Network/phala-cloud@fec66ed5886d4e7ee078efe2a15c5ad09496d24d -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Phala-Network
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@fec66ed5886d4e7ee078efe2a15c5ad09496d24d -
Trigger Event:
issue_comment
-
Statement type:
