Mindburn Labs
Founding Cohort

Python SDK

Cliente Python para o kernel HELM — API digitada com adaptadores de estrutura.

Python SDK

You may not need the SDK. The simplest integration is client = openai.OpenAI(base_url="http://localhost:8080/v1") — see the Quickstart. The SDK adds typed bindings and framework adapters.

The Python SDK ships in-repo at sdk/python/ and is published on PyPI as helm.

Install

pip install helm

Usage

Drop-in proxy (no SDK needed)

import openai

client = openai.OpenAI(base_url="http://localhost:8080/v1")

response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "List files in /tmp"}]
)
# X-Helm-Verdict: ALLOW

SDK client

from helm_sdk import HelmClient, HelmApiException

client = HelmClient(base_url="http://localhost:8080")

try:
    response = client.chat_completions(...)
except HelmApiException as e:
    print(f"Denied: {e.reason_code}")  # DENY_TOOL_NOT_FOUND

Framework adapters

Adapter Path Status
CrewAI sdk/python/crewai/ Active
LangChain sdk/python/langchain/ Active
LlamaIndex sdk/python/llamaindex/ Active
PydanticAI sdk/python/pydanticai/ Active
Google ADK sdk/python/google_adk/ Active
OpenAI Agents sdk/python/openai_agents/ Active
Microsoft Agents sdk/python/microsoft_agents/ Active

Next steps