Python SDK

Install the public Python client and CLI:

pip install -U hydracept
python -m hydracept init --apply --yes --json
python -m hydracept doctor
python -m hydracept smoke

Prefer python -m hydracept on Windows if hydracept.exe is not on PATH.

Smoke uses the Free-plan trial budget or BYOK. It is a real image job, not a no-op health check.

Workspace-aware invoke:

from hydracept import HydraceptWorkspace

with HydraceptWorkspace.open() as hydracept:
    result = hydracept.invoke("text.general.fast.v1", {"input": {"prompt": "hello"}})

See Quick Start and Durable jobs.

MCP interaction panel (0.3.8+)

Stdio MCP (python -m hydracept mcp serve) ships one Hydracept App at ui://hydracept/app.html with seven semantic surfaces: project.connect, capability.launch, connection.resolve, authorization.preflight, job.progress, artifact.review, and change.promote. Use hydracept_interaction_surface when a human decision or structured input is required. Upgrade with pip install -U hydracept (0.3.8+ recommended after the panel contract fixes).