logits-sdk 0.1.0

The Logits Python SDK facade over the official Tinker SDK (import as `logits`)

Logits Python SDK

logits-sdk is the official Python SDK for the Logits platform. Install it under the distribution name logits-sdk; application code imports it as logits.

Installation

pip install logits-sdk

Authentication

Set a Logits API key before creating clients:

export LOGITS_API_KEY="your-api-key"

For non-default deployments, set a base URL:

export LOGITS_BASE_URL="https://api.example.com"

Usage

import logits

service_client = logits.ServiceClient()
sampling_client = service_client.create_sampling_client(base_model="Qwen/Qwen3-8B")
future = sampling_client.sample(
    prompt=logits.ModelInput.from_ints([1, 2, 3]),
    num_samples=1,
    sampling_params=logits.SamplingParams(max_tokens=32),
)
result = future.result()

Async usage:

import logits

service_client = logits.ServiceClient()
sampling_client = await service_client.create_sampling_client_async(
    base_model="Qwen/Qwen3-8B"
)
result = await sampling_client.sample_async(
    prompt=logits.ModelInput.from_ints([1, 2, 3]),
    num_samples=1,
    sampling_params=logits.SamplingParams(max_tokens=32),
)

Close the underlying holder when a long-running process no longer needs the client:

service_client.holder.close()

Development

Install the package and test dependencies:

python -m pip install -e .
python -m pip install pytest pytest-timeout respx

Run the test suite:

pytest

Build and validate release artifacts:

python -m pip install build twine
python -m build
python -m twine check dist/*

Release Checklist

• Bump both pyproject.toml and src/logits/_version.py.
• Run pytest, python -m build, and python -m twine check dist/*.
• Confirm GitHub Actions CI is green on the release commit.
• Create a GitHub release from the version tag to trigger the publish workflow.