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() and create_embedding_model() return standard LangChain BaseChatModel / Embeddings instances. 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 -- CircuitBreaker and CircuitBreakerRegistry trip on repeated provider failures and recover on a timer. The factory's default breaker is per provider and per API key, so one caller's failing key never fast-fails another key on the same provider.
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.

Metadata

Release files for 3tears-models 0.56.1

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

Source distribution (sdist)

Source distribution for 3tears-models 0.56.1
File	Size	Uploaded
3tears_models-0.56.1.tar.gz	294.7 kB	Sep 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for 3tears-models 0.56.1
File	Interpreter	ABI	Platform	Reset
3tears_models-0.56.1-py3-none-any.whl 165.7 kB Sep 28, 2026	Python 3	none	any	Details

Total release size: 460.4 kB

Release files / 3tears_models-0.56.1.tar.gz

Download URL	3tears_models-0.56.1.tar.gz
Size	294.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a2199cc13aea04ebc62ea0a0b0ba59793bc71a0fcfe566321c07765fb15bde7f`
BLAKE2b-256 checksum How to use checksums	`90720bcec33332693be795d3b0679e14c1acca2c57bcfd9a1b7478e7ade7ed6e`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pacepace/3tears
Publishing commit: github.com/pacepace/3tears/tree/143bcfc3f969672fc23532500a859b5bd37cb0c6

Workflow

Publishing configuration: github.com/pacepace/3tears/blob/143bcfc3f969672fc23532500a859b5bd37cb0c6/.github/workflows/release.yml
Publishing logs: github.com/pacepace/3tears/actions/runs/36374372336/attempts/1

Artifact

Subject: 3tears_models-0.56.1.tar.gz
SHA-256 checksum: a2199cc13aea04ebc62ea0a0b0ba59793bc71a0fcfe566321c07765fb15bde7f Verifying attestations

Release files / 3tears_models-0.56.1-py3-none-any.whl

Download URL	3tears_models-0.56.1-py3-none-any.whl
Size	165.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`827577bfab5adad25be0e4f9e3f8ee4504842ed48ca9140669b13d1c87a2627b`
BLAKE2b-256 checksum How to use checksums	`72898ce7f53ca00935e8bbed035856dd33d5a3b49f7884f66b86c386b6481589`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pacepace/3tears
Publishing commit: github.com/pacepace/3tears/tree/143bcfc3f969672fc23532500a859b5bd37cb0c6

Workflow

Publishing configuration: github.com/pacepace/3tears/blob/143bcfc3f969672fc23532500a859b5bd37cb0c6/.github/workflows/release.yml
Publishing logs: github.com/pacepace/3tears/actions/runs/36374372336/attempts/1

Artifact

Subject: 3tears_models-0.56.1-py3-none-any.whl
SHA-256 checksum: 827577bfab5adad25be0e4f9e3f8ee4504842ed48ca9140669b13d1c87a2627b Verifying attestations