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.6.0.tar.gz (402.3 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.6.0-py3-none-any.whl (62.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for saidex-0.6.0.tar.gz
Algorithm Hash digest
SHA256 20174996c9e343c34e31004dca2fbf87b3904c2041eae485ecad657ea6a77a2b
MD5 e2961ac954e8b305a335540cec992f98
BLAKE2b-256 1f63fcdb719ec2315d83cf1b71b1b34c8b4efef5db35f52b0350f5f8ec1fcb5e

See more details on using hashes here.

Provenance

The following attestation bundles were made for saidex-0.6.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.6.0-py3-none-any.whl.

File metadata

  • Download URL: saidex-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 62.0 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.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6a0b91650b847ab23cb6204dbdd17acd247d3fd99c6e11e95254882735b527f0
MD5 5306d1461d8b0e770f1353c1494d111a
BLAKE2b-256 7e8c8e9134a395d4d50aa0d7c4bde82828706ffdde533fa806a3f75ba95fa5ea

See more details on using hashes here.

Provenance

The following attestation bundles were made for saidex-0.6.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