Skip to main content

Kothar Python SDK

Python SDK for the Kothar API.

Workshop API tokens

Create an immutable token in Account settings → API tokens, explicitly select its permissions, and save the credential when it is shown. Delete it to revoke access; create a replacement to change metadata, expiration, or grants. Non-expiring tokens keep their issued grants until revoked.

This example needs Files → List (All files) and Targets → List. Set the credential and the workspace/user IDs shown on the account page in environment variables. API tokens cannot use the session-only personal or me aliases.

import os
from kotharcomputing import KotharClient

client = KotharClient(access_token=os.environ["KOTHAR_API_TOKEN"])
files = client.workspaces.id(os.environ["KOTHAR_WORKSPACE_ID"]).files.list()
targets = client.users.id(os.environ["KOTHAR_USER_ID"]).targets.list()

Creating tasks also needs read access to the chosen task definition and any specified target.

Aleph language server

The SDK also provides a separate anonymous HTTP client for the Aleph language server. It does not use Kothar API authentication:

from kotharcomputing import AlephLanguageServerClient

aleph = AlephLanguageServerClient()
analysis = aleph.analyze('print("hello")', include_ast=True)
parsed = aleph.ast('print("hello")', format=True, discover_test=True)
tests = aleph.discover_tests('test "example" {}')
formatted = aleph.format('print( "hello" )')

HDF5 dataset reads

Generated operations use GET with no body and encode a nested ranges array as one JSON query parameter. Use [] for scalar/null dataspaces.

from kotharcomputing import ApiTransport
from kotharcomputing._generated.operations import read_file_dataset

transport = ApiTransport("https://api.kotharcomputing.com", access_token="YOUR_TOKEN")
response = read_file_dataset(
    transport,
    workspace_id="WORKSPACE_ID",
    path="measurements.h5",
    version_id="immutable-version-id",
    object_path="/samples",
    ranges=[[0, 10, 2]],
)
selection = response.json()  # shape, datatype, values; optional base64 data

Use representation="binary" and response.body for little-endian numeric/enum bytes or decoded scalar-string bytes; response.headers preserves identity and dtype metadata. Fixed-length string arrays require JSON. Enum symbols contain exact decimal codes; JSON values retain the existing 64-bit tags. External callers must replace POST reads with GET; stored files need no migration.

Metadata

Release files for kotharcomputing 1.5.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 kotharcomputing 1.5.0
File Size Uploaded Provenance Actions
kotharcomputing-1.5.0.tar.gz 29.8 kB Without provenance Details for kotharcomputing-1.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kotharcomputing 1.5.0
File Interpreter ABI Platform Actions
kotharcomputing-1.5.0-py3-none-any.whl Python 3 none any Details for kotharcomputing-1.5.0-py3-none-any.whl

Total release size: 60.5 kB

Release files / kotharcomputing-1.5.0.tar.gz

Download URL kotharcomputing-1.5.0.tar.gz
Size 29.8 kB
Tags Source
SHA-256 checksum
How to use checksums
03df8fac8033318bdcd0e5421206c9803da6b0fa2657d8d396dc91d94954a54a
BLAKE2b-256 checksum
How to use checksums
84747042414c660e1237232dd68286f08055e13610b7d01b821b534ad425a8c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / kotharcomputing-1.5.0-py3-none-any.whl

Download URL kotharcomputing-1.5.0-py3-none-any.whl
Size 30.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
69c3479935f1a8e7710111b80d049b880dcf25cf880f07a69363e0d6e594047e
BLAKE2b-256 checksum
How to use checksums
ffc3a67ae4faac2706a7acf19e0605e6266c83cf829005aa262b9bd2c6b84e0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for kotharcomputing 1.5.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.5.0 This release

2 release files No provenance

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