retab 0.0.141

Retab official python library

Retab

The AI Automation Platform

Made with love by the team at Retab 🤍.

Our Website | Documentation | Discord | Twitter

---

What is Retab?

Retab solves all the major challenges in document processing with Large Language Models:

1. Universal Document Preprocessing: Convert any file type (PDFs, Excel, emails, etc.) into LLM-ready format without writing custom parsers
2. Structured, Schema-driven Extraction: Get consistent, reliable outputs using schema-based prompt engineering
3. Processors: Publish a live, stable, shareable document processor.
4. Automations: Create document processing workflows that can be triggered by events (mailbox, upload link, endpoint, outlook plugin).
5. Optimizations: Identify the most used processors and help you finetune models to reduce costs and improve performance

We are offering you all the software-defined primitives to build your own document processing solutions. We see it as Stripe for document processing.

Our goal is to make the process of analyzing documents and unstructured data as easy and transparent as possible.

A new, lighter paradigm Large Language Models collapse entire layers of legacy OCR pipelines into a single, elegant abstraction. When a model can read, reason, and structure text natively, we no longer need brittle heuristics, handcrafted parsers, or heavyweight ETL jobs. Instead, we can expose a small, principled API: "give me the document, tell me the schema, and get back structured truth." Complexity evaporates, reliability rises, speed follows, and costs fall—because every component you remove is one that can no longer break. LLM‑first design lets us focus less on plumbing and more on the questions we actually want answered.

Many people haven't yet realized how powerful LLMs have become at document processing tasks - we're here to help unlock these capabilities.

---

Go further

• Quickstart
• API Reference

---

Code examples

You can check our Github repository to see code examples: python examples and jupyter notebooks.

Workflow Specs

Use client.workflows.specs to validate, plan, apply, and export declarative workflow YAML.

from retab import Retab

client = Retab()

validation = client.workflows.specs.validate(yaml_definition)
plan = client.workflows.specs.plan(yaml_definition)
result = client.workflows.specs.apply(yaml_definition)
exported = client.workflows.specs.export(result.workflow_id)

Declarative specs use apiVersion: workflows.retab.com/v1alpha2 and explicit edge handles:

edges:
  - from:
      block: start-node
      handle: output-file-0
    to:
      block: extract-node
      handle: input-file-source_doc

Workflow Artifacts

Workflow steps expose artifact as a stable {operation, id} pointer. Use client.workflows.artifacts to fetch the persisted record behind that pointer, including HIL evaluations, conditional matches, function outputs, and API-call attempts.

run = client.workflows.runs.create_and_wait(
    workflow_id="workflow_abc123",
    documents={"start-node": "invoice.pdf"},
)

step = client.workflows.runs.steps.get(run.id, "hil-node")
if step.artifact:
    artifact = client.workflows.artifacts.get(step.artifact)
    print(artifact.operation)
    print(artifact.requires_human_review)
    print(artifact.evaluations)

all_artifacts = client.workflows.artifacts.list(run.id)

Community

Let's create the future of document processing together!

Join our discord community to share tips, discuss best practices, and showcase what you build. Or just tweet at us.

We can't wait to see how you'll use Retab.

• Discord
• Twitter

---

Roadmap

We share our roadmap publicly on Github

Among the features we're working on:

• Node.js SDK
• Schema optimization autopilot
• Sources API