Base

iso8583sim.llm.base This module defines the abstract base class for LLM providers, allowing multiple backend implementations (Anthropic, OpenAI, Google, Ollama).

`LLMResponse`

LLMResponse(
    content: str,
    model: str,
    provider: str,
    usage: dict[str, int] | None = None,
)

Response from an LLM provider.

`LLMError`

Bases: Exception Base exception for LLM-related errors.

`ProviderNotAvailableError`

Bases: LLMError

ProviderNotAvailableError(provider: str, package: str)

Raised when a provider’s dependencies are not installed.

`ProviderConfigError`

Bases: LLMError Raised when provider configuration is invalid.

`GenerationError`

Bases: LLMError Raised when message generation fails.

`LLMProvider`

Bases: ABC Abstract base class for LLM providers. All LLM providers must implement this interface to be compatible with MessageExplainer and MessageGenerator. Example

class MyProvider(LLMProvider):
    def complete(self, prompt, system=None):
        return "response"
    @property
    def name(self):
        return "my-provider"

`complete()`

def complete(prompt: str, system: str | None = None) -> str

Send a prompt to the LLM and return the response text. Parameters

str

required

The user prompt to send

str | None

default:"None"

Optional system prompt for context

str

The LLM’s response text

Raises

LLMError: If the API call fails

`name`

Return the provider name for logging/display.

`model`

Return the model name being used.

`complete_with_metadata()`

def complete_with_metadata(prompt: str, system: str | None = None) -> LLMResponse

Send a prompt and return response with metadata. Default implementation wraps complete(). Providers can override for more detailed metadata. Parameters

str

required

The user prompt to send

str | None

default:"None"

Optional system prompt for context

LLMResponse

LLMResponse with content and metadata

Core

Security

Wire formats

Networking

LLM

Servers

Demo

`LLMResponse`

`LLMError`

`ProviderNotAvailableError`

`ProviderConfigError`

`GenerationError`

`LLMProvider`

`complete()`

`name`

`model`

`complete_with_metadata()`

​LLMResponse

​LLMError

​ProviderNotAvailableError

​ProviderConfigError

​GenerationError

​LLMProvider

​complete()

​name

​model

​complete_with_metadata()

`LLMResponse`

`LLMError`

`ProviderNotAvailableError`

`ProviderConfigError`

`GenerationError`

`LLMProvider`

`complete()`

`name`

`model`

`complete_with_metadata()`