Skip to main content

Caracal Python SDK

This directory contains the canonical Python SDK implementation.

Installation

pip install caracal-sdk

Optional extras:

# Async helpers
pip install "caracal-sdk[async]"

# Integration with caracal-core runtime
pip install "caracal-sdk[core]"

Layout

  • src/caracal_sdk/: Open-source SDK surface and transport adapters
  • src/caracal_sdk/enterprise/: Enterprise-only extension points

Goals

  • Keep SDK surface area minimal and explicit
  • Preserve parity with the Node SDK in sdk/node-sdk/
  • Support CLI/TUI integrations with stable core abstractions
  • Ship as a standalone package independent of core internals

Runtime Endpoint

By default, the SDK targets http://localhost:${CARACAL_API_PORT:-8000}.

To target a different containerized runtime endpoint (broker or enterprise), set:

export CARACAL_API_PORT=8000
export CARACAL_API_URL=http://localhost:8000

or pass base_url directly when constructing CaracalClient.

Metadata

Release files for caracal-sdk 0.1.0

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

Source distribution (sdist)

Source distribution for caracal-sdk 0.1.0
File Size Uploaded
caracal_sdk-0.1.0.tar.gz 18.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for caracal-sdk 0.1.0
File Interpreter ABI Platform
caracal_sdk-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 44.3 kB

Release files / caracal_sdk-0.1.0.tar.gz

Download URL caracal_sdk-0.1.0.tar.gz
Size 18.2 kB
Tags Source
SHA-256 checksum
How to use checksums
8b4048a455af09f663b1275858b0abec39c96c498b9505d77a4b9b5261167d20
BLAKE2b-256 checksum
How to use checksums
0f8b891ef4da394646ad8e4a82c00b77f9a1d6f492b68f10cdcb49895cd2bc72
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / caracal_sdk-0.1.0-py3-none-any.whl

Download URL caracal_sdk-0.1.0-py3-none-any.whl
Size 26.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4f54fefd011ea38530ca72f40b6e0af0bb4bf80fff33b59cac7b7b8900a7bb39
BLAKE2b-256 checksum
How to use checksums
bb63b3ac3d4d58ac11cfcf307889c8b0f9db223d4a6a97dd07fc72f453496eed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

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