3tears-models
LangChain-native AI model factories for the 3tears framework. Build chat and embedding models from a single call, with capability metadata, circuit breakers, error translation, and usage tracking wired in.
pip install 3tears-models
What you get
- Factories --
create_chat_model()andcreate_embedding_model()return standard LangChainBaseChatModel/Embeddingsinstances. No custom runtime protocols to learn. - Providers -- Anthropic, OpenAI, OpenRouter, VoyageAI, Whisper, and image backends (OpenAI Images, HuggingFace, A1111, ModelsLab, ComfyUI).
- Capability registry --
get_capabilities(),register_capabilities(), and per-model overrides describe context windows, vision support, tool support, and tier. - Circuit breakers --
CircuitBreakerandCircuitBreakerRegistrytrip on repeated provider failures and recover on a timer. - Usage tracking --
UsageTracker.record()emits an OpenTelemetry span plus Prometheus instruments, with optional per-application audit and counter sinks. - Message hygiene --
preprocess_messages(),enforce_alternating_roles(),filter_invalid_tool_calls(), and streaming chunk helpers (parse_chunk,merge_chunks).
Quickstart
from threetears.models import create_chat_model, create_embedding_model
chat = create_chat_model("claude-sonnet-4-6")
reply = await chat.ainvoke("Summarize three-tier caching in one sentence.")
embedder = create_embedding_model("voyage-3")
vectors = await embedder.aembed_documents(["first doc", "second doc"])
Capabilities, circuit breakers, and usage tracking attach automatically. Reach for the registry and tracker APIs directly when you need to inspect or override them.
License
MIT. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file 3tears_models-0.23.8.tar.gz.
File metadata
- Download URL: 3tears_models-0.23.8.tar.gz
- Upload date:
- Size: 177.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a3a5e9ee8e16846982e3b070366c012d7660896a3fd58e70e657fe8a6afca272
|
|
| MD5 |
8e21d999a161dd2596eb2f9420313654
|
|
| BLAKE2b-256 |
4ab82211e22f8ae186875a91562116d7589ccda395add96c55d75d2f59c35d15
|
Provenance
The following attestation bundles were made for 3tears_models-0.23.8.tar.gz:
Publisher:
release.yml on pacepace/3tears
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
3tears_models-0.23.8.tar.gz -
Subject digest:
a3a5e9ee8e16846982e3b070366c012d7660896a3fd58e70e657fe8a6afca272 - Sigstore transparency entry: 2397716205
- Sigstore integration time:
-
Permalink:
pacepace/3tears@e7a7985fa615aa9246b0e9030d02cdb2eef56c6f -
Branch / Tag:
refs/tags/v0.23.8 - Owner: https://github.com/pacepace
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e7a7985fa615aa9246b0e9030d02cdb2eef56c6f -
Trigger Event:
push
-
Statement type:
File details
Details for the file 3tears_models-0.23.8-py3-none-any.whl.
File metadata
- Download URL: 3tears_models-0.23.8-py3-none-any.whl
- Upload date:
- Size: 112.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
34ea853259a4deb665f8f98c1a661ccc7eab83aac4e478b03e22665189d9d0fa
|
|
| MD5 |
fd0ea8fb63fb9647181ae1459092f983
|
|
| BLAKE2b-256 |
f17efda4c93d9c17cd595c375bc17edc3dda5fc2b5815fcd1002b8620a0f5d27
|
Provenance
The following attestation bundles were made for 3tears_models-0.23.8-py3-none-any.whl:
Publisher:
release.yml on pacepace/3tears
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
3tears_models-0.23.8-py3-none-any.whl -
Subject digest:
34ea853259a4deb665f8f98c1a661ccc7eab83aac4e478b03e22665189d9d0fa - Sigstore transparency entry: 2397717679
- Sigstore integration time:
-
Permalink:
pacepace/3tears@e7a7985fa615aa9246b0e9030d02cdb2eef56c6f -
Branch / Tag:
refs/tags/v0.23.8 - Owner: https://github.com/pacepace
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e7a7985fa615aa9246b0e9030d02cdb2eef56c6f -
Trigger Event:
push
-
Statement type:
