dr-providers 0.1.1

OpenRouter LLM query client with typed requests and responses.

dr-providers

OpenRouter LLM query client with typed requests and responses. Requires Python 3.12+.

Install

pip install dr-providers

Or with uv:

uv add dr-providers

Optional CLI

pip install "dr-providers[cli]"
python -m dr_providers.cli --help

Authentication

Set your OpenRouter API key:

export OPENROUTER_API_KEY="sk-or-..."

Library usage

from dr_providers import (
    LlmRequest,
    Message,
    MessageRole,
    OpenRouterProvider,
    ProviderName,
)

with OpenRouterProvider() as provider:
    response = provider.generate(
        LlmRequest(
            provider=ProviderName.OPENROUTER,
            model="openai/gpt-4o-mini",
            messages=[
                Message(role=MessageRole.USER, content="Say hello in one word."),
            ],
        )
    )
    print(response.text)

Prompt helper

For scripts and demos, query_from_prompt builds a request from plain strings:

from dr_providers import OpenRouterProvider, ProviderName
from dr_providers.query.from_prompt import query_from_prompt

with OpenRouterProvider() as provider:
    response = query_from_prompt(
        provider,
        ProviderName.OPENROUTER,
        model="openai/gpt-4o-mini",
        prompt="Say hello in one word.",
    )

This helper is not re-exported from the top-level package.

Public API

Import stable symbols from the top-level package:

from dr_providers import LlmRequest, OpenRouterProvider, ReasoningSpec

See dr_providers.__all__ for the full list.

Development

uv sync --frozen
uv run pre-commit install
uv run pre-commit run --all-files

Run the CLI from the repo without installing:

uv run python -m dr_providers.cli --model openai/gpt-4o-mini -m "hi"

Audit corpus ground truth

This repo includes a small audit-output corpus and curated ground-truth normalization artifacts under data/audit-corpus/. Regenerate the parsed audit and analysis files with:

uv run python scripts/generate_audit_ground_truth.py \
  --corpus-dir data/audit-corpus \
  --output-dir data/audit-corpus/ground-truth