retab 0.0.144

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 Spec

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

from retab import Retab

client = Retab()

validation = client.workflows.spec.validate(yaml_definition)
plan = client.workflows.spec.plan(yaml_definition)
result = client.workflows.spec.apply(yaml_definition)
exported = client.workflows.spec.get(result.workflow_id)

A declarative spec uses apiVersion: workflows.retab.com/v1alpha2 and explicit edge handles:

edges:
  - from:
      block: start_document-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 review evaluations, conditional matches, function outputs, and API-call attempts. Review decisions live on the review queue APIs; artifact records are for inspecting why a branch or gate fired.

import time

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

while run.lifecycle.status not in {"completed", "error", "failed", "cancelled"}:
    time.sleep(1)
    run = client.workflows.runs.get(run.id)

steps = client.workflows.steps.list(run_id=run.id)
review_step = next((step for step in steps if step.block_id == "review-node"), None)
if review_step is not None:
    step = client.workflows.steps.get(review_step.step_id, run_id=run.id)

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