Metadata-Version: 2.4
Name: aqven-llm
Version: 0.0.3
Summary: Provider isolation for aqven: every model provider SDK import behind one factory.
Keywords: ai,llm,providers,pydantic-ai
Author: Kirill Burkhanov
License-Expression: LicenseRef-AQVEN-1.0.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Dist: pydantic==2.13.5
Requires-Dist: httpx2==2.13.0
Requires-Dist: pydantic-ai-slim[openrouter]==2.43.0
Requires-Dist: openai==3.14.1
Requires-Dist: tenacity==9.1.4
Requires-Dist: genai-prices==0.1.7
Requires-Dist: pydantic-ai-slim[anthropic]==2.43.0 ; extra == 'anthropic'
Requires-Dist: pydantic-ai-slim[bedrock]==2.43.0 ; extra == 'bedrock'
Requires-Dist: pydantic-ai-slim[cohere]==2.43.0 ; extra == 'cohere'
Requires-Dist: pydantic-ai-slim[google]==2.43.0 ; extra == 'google'
Requires-Dist: pydantic-ai-slim[groq]==2.43.0 ; extra == 'groq'
Requires-Dist: pydantic-ai-slim[huggingface]==2.43.0 ; extra == 'huggingface'
Requires-Dist: pydantic-ai-slim[mistral]==2.43.0 ; extra == 'mistral'
Requires-Dist: pydantic-ai-slim[xai]==2.43.0 ; extra == 'xai'
Requires-Python: >=3.14, <3.15
Project-URL: Homepage, https://aqvenstudio.com
Project-URL: Documentation, https://aqvenstudio.com
Project-URL: Repository, https://github.com/lastonoga/AQVEN
Project-URL: Issues, https://github.com/lastonoga/AQVEN/issues
Provides-Extra: anthropic
Provides-Extra: bedrock
Provides-Extra: cohere
Provides-Extra: google
Provides-Extra: groq
Provides-Extra: huggingface
Provides-Extra: mistral
Provides-Extra: xai
Description-Content-Type: text/markdown

# aqven-llm

**Provider isolation for [AQVEN](https://pypi.org/project/aqven/).** Every import of a model provider SDK
lives in this one package, behind a single factory. The rest of the engine receives a ready `Model` and never
imports `openai`, `anthropic`, `google.genai` or the provider modules of Pydantic AI.

📖 **[Documentation](https://aqvenstudio.com)** · 🔌 **[Models and providers](https://aqvenstudio.com/engineering/providers/)** · 📚 **[API reference](https://aqvenstudio.com/engineering/reference/)**

---

## Why a separate package

Provider SDKs are the least stable part of an LLM stack: they change shape, they bring their own HTTP clients,
and they each retry differently. Letting them leak across a codebase makes every one of those changes a
cross-cutting one.

`aqven-llm` draws a hard boundary. The engine asks for a model by reference and gets one back; the guarantee
chain — retries, budgets, cassettes, instrumentation — is layered on top of it uniformly, whichever provider
answered. The boundary is enforced, not just documented: a lint rule fails the build if a provider import
appears anywhere else.

## Install a provider

Providers are extras, so you only install the SDKs you actually call:

```bash
uv add "aqven-llm[anthropic]"
```

Available extras: `anthropic`, `bedrock`, `cohere`, `google`, `groq`, `huggingface`, `mistral`, `xai`.
OpenAI is included by default, and OpenAI-compatible gateways such as OpenRouter and Together go through it.

Custom providers can register themselves through an entry point, without changing this package.

## Usually you do not install this directly

`aqven-llm` is a dependency of `aqven` and is pinned to the same version. Install
[`aqven`](https://pypi.org/project/aqven/) instead — it brings this package with it, along with Studio.

```bash
uv tool install aqven
```

## Keywords

LLM provider abstraction · model factory · OpenAI · Anthropic · Google Gemini · Bedrock · Mistral · Cohere ·
Groq · xAI · OpenRouter · Pydantic AI · structured output · streaming

## License

AQVEN License 1.0.0, based on [PolyForm Shield 1.0.0](https://polyformproject.org/licenses/shield/1.0.0) —
source-available. Use it for any purpose, including in production and in commercial products you build with it.
You may not use it to provide a product that competes with AQVEN, and you may redistribute AQVEN itself
only free of charge and for a non-commercial purpose.

Copyright Kirill Burkhanov.
