Skip to main content

levain-sdk

The Python interface that Levain agent recipes are written against: node helpers, the agentic engine, state reducers, and tool annotations.

A recipe's node functions import from levain_sdk, so this package is what makes a cloned recipe installable and readable in your editor — type checking, completion, and uv sync all resolve against it. Agents execute on the Levain platform; this package defines the contract, it does not run them.

Install

Recipe packages already declare levain-sdk, so inside a cloned recipe:

uv sync

Or directly:

pip install levain-sdk

Extras

  • models — direct (non-agentic) LLM calls via levain_sdk.models.
  • review — helpers used by review-oriented recipes.
  • crawler — main-content extraction for crawling recipes.

Most recipes need none of these; the error message will name the extra if a module you import requires one.

Wiki

levain_sdk.wiki reads the workspace knowledge base from node code, with no agent loop: read_page(path), search(query, limit) and list_pages(). All three are async, take their configuration from the sandbox environment, and report failures as {"error": ..., "code": ...} rather than raising. The Knowledge Base guide has the example and the list of codes.

Authoring recipes

Validation and code generation live in the companion tool, levain-cli. The full authoring guide is at docs.levainlabs.com.

License

Apache-2.0.

Metadata

Release files for levain-sdk 0.1.158

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for levain-sdk 0.1.158
File Size Uploaded Provenance
levain_sdk-0.1.158.tar.gz 187.1 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for levain-sdk 0.1.158
File Interpreter ABI Platform
levain_sdk-0.1.158-py3-none-any.whl Python 3 none any Details

Total release size: 412.8 kB

Release files / levain_sdk-0.1.158.tar.gz

Download URL levain_sdk-0.1.158.tar.gz
Size 187.1 kB
Tags Source
SHA-256 checksum
How to use checksums
1cabfeb9a473a003fb30d769ce3cc0525967f1d72a145d29f37391db914b08f4
BLAKE2b-256 checksum
How to use checksums
b1fbaa6c19067cd18b8b9a542696331413d8406dee8234ce0283fcbaedd61da7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Release files / levain_sdk-0.1.158-py3-none-any.whl

Download URL levain_sdk-0.1.158-py3-none-any.whl
Size 225.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a2ecd4cd1c2df0f0515f43527f46719a9f19ff8e1949fbbf25052fefd2d69d46
BLAKE2b-256 checksum
How to use checksums
9c756fc8ee11c155e955195be3edc18df57097cef561a5dd2639b7c9d353f334
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Security for levain-sdk 0.1.158

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for levain_sdk-0.1.158.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page