Skip to main content

xyberos-llm-providers

Remaining LLM providers plugin — RFC-0019, M6. Thin configs, no new architecture. The long tail of OpenAI-compatible providers are covered by presets over the core OpenAICompatibleLLM; Azure OpenAI, AWS Bedrock and Google Vertex AI get dedicated LLMProvider adapters.

Install

pip install -e ./llm-providers
pip install xyberos[llm-providers]   # optional: boto3 + google-auth for Bedrock/Vertex

Provider presets (OpenAI-compatible — one line each)

provider base URL default model API key env
openai api.openai.com/v1 gpt-4o-mini OPENAI_API_KEY
mistral api.mistral.ai/v1 mistral-small-latest MISTRAL_API_KEY
groq api.groq.com/openai/v1 llama-3.3-70b-versatile GROQ_API_KEY
deepseek api.deepseek.com/v1 deepseek-chat DEEPSEEK_API_KEY
cohere api.cohere.com/compatibility/v1 command-r-plus COHERE_API_KEY
together api.together.xyz/v1 Llama-3.3-70B-Instruct-Turbo TOGETHER_API_KEY
xai api.x.ai/v1 grok-2 XAI_API_KEY
openrouter openrouter.ai/api/v1 openrouter/auto OPENROUTER_API_KEY
from xyberos_llm_providers import get_llm
llm = get_llm("groq")                      # key from GROQ_API_KEY
print(llm.generate("Say hi"))

Dedicated adapters

  • Azure OpenAIAzureOpenAILLM(deployment, endpoint=..., api_key=...) posts to the Azure deployments endpoint with an api-key header (AZURE_OPENAI_ENDPOINT, AZURE_OPENAI_API_KEY, AZURE_OPENAI_DEPLOYMENT).
  • AWS BedrockBedrockLLM(model_id) over bedrock-runtime.converse (lazy boto3; region from AWS_REGION/AWS_DEFAULT_REGION).
  • Google Vertex AIVertexAILlm(model, project=...) over the generateContent REST API (lazy google-auth token; VERTEX_AI_PROJECT/GOOGLE_CLOUD_PROJECT).

Plugin usage

from xyberos import create_app
from xyberos_llm_providers import LlmProvidersPlugin

app = create_app()
app.load_plugin(LlmProvidersPlugin(provider="deepseek"))   # or set LLM_PROVIDER=deepseek
print(app.llm.generate("Say hi"))

provider accepts a preset name or azure_openai / bedrock / vertex. An unconfigured plugin registers nothing (logs a warning); calling plugin.llm() directly surfaces misconfiguration errors.

Examples

  • examples/llm_providers.py — lists presets and runs one; --stub for a no-network demo, otherwise a real call.

Tests

pip install pytest
pytest tests/

All adapters are tested against stub transports / fake clients — no network, no SDKs required. Bedrock/Vertex lazy-import tests skip when their SDK is present.

Ship location

Plugin (xyberos.plugins entry point) / [llm-providers] extra. One LLMProvider contract; providers are implementations of it.

Download files

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

Source Distribution

xyberos_llm_providers-0.1.0.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

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

xyberos_llm_providers-0.1.0-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file xyberos_llm_providers-0.1.0.tar.gz.

File metadata

  • Download URL: xyberos_llm_providers-0.1.0.tar.gz
  • Upload date:
  • Size: 10.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for xyberos_llm_providers-0.1.0.tar.gz
Algorithm Hash digest
SHA256 86fd99c908eb5db05fe4e509b86dc8be9af64cb4b80003cb47de9010c8c4c343
MD5 b70b3dc0a74b24c27f01b6ad5a2ed408
BLAKE2b-256 f610b2933393dd2dadea8669f1c53b7245ee32756d6d06673d57587072886eba

See more details on using hashes here.

Provenance

The following attestation bundles were made for xyberos_llm_providers-0.1.0.tar.gz:

Publisher: pypi-plugins.yml on xyberos/xyberos-plugins

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

File details

Details for the file xyberos_llm_providers-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for xyberos_llm_providers-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0ee0f457e4acd4dab34ffc74bd18ee91ef04de2e03d660936c5e179d6f913eb6
MD5 6930d9d4ea72f03653f50ceb13754e0f
BLAKE2b-256 7bb8f87ceb16dca71bd4340ae41cdfc95f76cd43fc54245057fbbccfe31cab8f

See more details on using hashes here.

Provenance

The following attestation bundles were made for xyberos_llm_providers-0.1.0-py3-none-any.whl:

Publisher: pypi-plugins.yml on xyberos/xyberos-plugins

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

Supported by

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