Skip to main content

SAIDEX — Structured AI Data Extraction

CI PyPI Python 3.10+ License: Apache 2.0

Extract validated Pydantic models from LLM responses — with automatic retry, field-level error feedback, an optional fallback model, and an agentic tool loop.

Works with any LangChain-compatible model: GPT-4o, Claude, Gemini, and local models via Ollama or vLLM. No tool-calling support required — use ExtractionMode.JSON for any chat model.

Installation

pip install saidex

With automatic OpenAI rate-limit handling:

pip install "saidex[openai]"

Quick start

import asyncio
from pydantic import BaseModel, Field
from langchain_openai import ChatOpenAI
from saidex import extract_data_from_text

class PersonInfo(BaseModel):
    name: str
    age: int
    occupation: str

async def main():
    llm = ChatOpenAI(model="gpt-4o-mini", temperature=0)

    person, stats = await extract_data_from_text(
        llm,
        PersonInfo,
        "Alice Müller, 34, works as a software engineer in Munich.",
    )

    print(person)               # name='Alice Müller' age=34 occupation='software engineer'
    print(stats.total_retries)  # 0 — first attempt was valid

asyncio.run(main())

Key features

Feature Detail
Validated output Pydantic validation with field-level error feedback fed back to the LLM for self-correction
Auto-retry Configurable retries with exponential back-off for transient errors and rate limits
Fallback model Pair a cheap primary with a powerful fallback — pay for the big model only when needed
No tool-calling required ExtractionMode.JSON works with any chat model including local models via Ollama / vLLM
Agentic tool loop Give the LLM your own tools (lookups, API calls) — it calls them freely, then delivers a validated final answer
Multimodal Pass images via standard LangChain messages to any vision-capable model
LangChain-native Plugs into any LangChain chat model; supports callbacks (Langfuse, LangSmith, …)

Links

License

Copyright 2026 Martin Lauff. Licensed under the Apache License, Version 2.0.

Download files

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

Source Distribution

saidex-0.3.0.tar.gz (364.2 kB view details)

Uploaded Source

Built Distribution

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

saidex-0.3.0-py3-none-any.whl (44.4 kB view details)

Uploaded Python 3

File details

Details for the file saidex-0.3.0.tar.gz.

File metadata

  • Download URL: saidex-0.3.0.tar.gz
  • Upload date:
  • Size: 364.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for saidex-0.3.0.tar.gz
Algorithm Hash digest
SHA256 9cbf29bb5c0eb1fedc8f23c413fb5b87d16f6a3f70923196d112d0615504341a
MD5 16e928ae58adf2a7b3b72d7c20b9f255
BLAKE2b-256 6c7e6f72f9524b06f6726a6da377bc0c48b26a443eab3e0f42a5e69a7f92b20d

See more details on using hashes here.

Provenance

The following attestation bundles were made for saidex-0.3.0.tar.gz:

Publisher: release.yml on mlauf-labs/SAIDEX

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

File details

Details for the file saidex-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: saidex-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 44.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for saidex-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 91d8dbc1d96795ab16d8c69cb286fec71d4e5e92c50cb7417c3f7981137d74b9
MD5 b66bb957849851562db3505fba258611
BLAKE2b-256 70e13c8fa95ed5c4b153d7b0e72b75a5fa87d0e20e1d488b311fbe0e5b534bad

See more details on using hashes here.

Provenance

The following attestation bundles were made for saidex-0.3.0-py3-none-any.whl:

Publisher: release.yml on mlauf-labs/SAIDEX

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