Skip to main content

Collinear Python SDK

Persona‑driven chat simulation for OpenAI‑compatible endpoints.

Requires Python 3.10+.

Install (uv)

uv venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv add collinear
uv sync

Quickstart

import os
from collinear.client import Client

client = Client(
    assistant_model_url="https://api.openai.com/v1",
    assistant_model_api_key=os.environ["OPENAI_API_KEY"],
    assistant_model_name="gpt-4o-mini",
    collinear_api_key=os.environ.get("COLLINEAR_API_KEY"),
)

traitmix_config = {
    "ages": ["25-34"],
    "genders": ["woman"],
    "occupations": ["Employed"],
    "intents": ["Resolve billing issue"],
    "traits": {"impatience": ["low", "medium", "high"]},
    "locations": ["United States"],
    "languages": ["English"],
    "tasks": ["telecom support"],
}

results = client.simulate(
    traitmix_config,
    k=1,
    num_exchanges=2,
    traitmix_temperature=0.7,
    traitmix_max_tokens=256,
)

assessment = client.assess(results)
for row in assessment.evaluation_result:
    for score in row.values():
        print("score=", score.score, "rationale=", score.rationale)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collinear-1.0.26.tar.gz (73.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

collinear-1.0.26-py3-none-any.whl (47.5 kB view details)

Uploaded Python 3

File details

Details for the file collinear-1.0.26.tar.gz.

File metadata

  • Download URL: collinear-1.0.26.tar.gz
  • Upload date:
  • Size: 73.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for collinear-1.0.26.tar.gz
Algorithm Hash digest
SHA256 252cc9b09d5d9cb2df0cef4d7abf1d1f0c6643d7b46f288aae5a6e01990e7c3f
MD5 6f4dc6ec95ea11a5f3287eb68fa3d73e
BLAKE2b-256 4d018f3e5746bcd5f16c2a382ac3e005c3a85d85fc63f816a2bcd472d12549e1

See more details on using hashes here.

Provenance

The following attestation bundles were made for collinear-1.0.26.tar.gz:

Publisher: release.yml on collinear-ai/collinear-python-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file collinear-1.0.26-py3-none-any.whl.

File metadata

  • Download URL: collinear-1.0.26-py3-none-any.whl
  • Upload date:
  • Size: 47.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for collinear-1.0.26-py3-none-any.whl
Algorithm Hash digest
SHA256 cc7e8e9db8e530c21fb3dce69fe4f1d12ee5c4337f51d3d92814803b125e42c3
MD5 a2e2cbc5dcb054fe3a55b0b8a17fdf12
BLAKE2b-256 f06030d38c3a97079f4e88db5bd1527a6475985ffdb9494dd566576b141c56e8

See more details on using hashes here.

Provenance

The following attestation bundles were made for collinear-1.0.26-py3-none-any.whl:

Publisher: release.yml on collinear-ai/collinear-python-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page