`weft-sdk` for Python

The supported Python buyer client for Weft. Generated OpenAPI APIs remain available under weft_sdk.generated as an advanced escape hatch.

Install and authenticate

Create a buyer wk_* key in Dashboard → API keys, then:

pip install weft-sdk
export WEFT_API_KEY="wk_..."

Search

import os

from weft_sdk import Client

api_key = os.environ["WEFT_API_KEY"]
with Client(api_key=api_key) as weft:
    account = weft.me()
    results = weft.search(query="weather data API", max_results=5)

print(account.data)
print(results.results)

The client defaults to https://weft.network.

Bounded paid fetch

Paid fetches require both a maximum cost and an idempotency key. Reuse the key when retrying the same logical purchase after an uncertain response.

from uuid import uuid4

idempotency_key = str(uuid4())
artifact = weft.fetch(
    url="https://merchant.example/data",
    max_cost_usd="0.05",
    idempotency_key=idempotency_key,
)

Handle API errors

All buyer-client methods raise the same WeftError shape, including the HTTP status, stable error code, request ID, retry hint, and structured details.

from weft_sdk import WeftError

try:
    results = weft.search(query="weather data API")
except WeftError as error:
    print(error.status, error.code, error.request_id, error.retryable)
    print(error.details)
    raise

401: confirm that WEFT_API_KEY contains a current buyer wk_* key.
403: inspect code and details for an insufficient balance or spending policy denial before changing the request.
409 (IDEMPOTENCY_CONFLICT): this buyer already used the supplied idempotency key for a different fetch request. Generate a new key for the new operation; the original operation retries unchanged with its own key. retryable is False — resending the conflicting request will conflict again.
429: honor Retry-After and back off.
5xx: retry transient failures with backoff; reuse the idempotency key for a paid fetch.
status == 0 (NETWORK_ERROR): the request failed before any Weft response, so the outcome is uncertain. retryable is True; retry with backoff and reuse the idempotency key for a paid fetch.

See the API reference for the complete contract.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

weft_sdk-0.20.0.tar.gz (99.0 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

weft_sdk-0.20.0-py3-none-any.whl (343.9 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file weft_sdk-0.20.0.tar.gz.

File metadata

Download URL: weft_sdk-0.20.0.tar.gz
Upload date: Aug 26, 2026
Size: 99.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for weft_sdk-0.20.0.tar.gz
Algorithm	Hash digest
SHA256	`928ef83b36cdd7ffeacae2e4bb0ea1a961d0219c5a91eab2748a5c19332c935d`
MD5	`266c504442c2ca52228ae8cfe13902c9`
BLAKE2b-256	`e4f794489414ed4c877cd50e1fe30b58232a5b94eea476d8f97e92a1818c7d55`

See more details on using hashes here.

Provenance

The following attestation bundles were made for weft_sdk-0.20.0.tar.gz:

Publisher: python.yml on weft-labs/weft-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: weft_sdk-0.20.0.tar.gz
- Subject digest: 928ef83b36cdd7ffeacae2e4bb0ea1a961d0219c5a91eab2748a5c19332c935d
- Sigstore transparency entry: 2606539125
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: weft-labs/weft-sdk@cc8c65387c5cb3468802b9306c154a43c6e50f55
- Branch / Tag: refs/tags/v0.20.0
- Owner: https://github.com/weft-labs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python.yml@cc8c65387c5cb3468802b9306c154a43c6e50f55
- Trigger Event: push