convez.ai
MCP ServerAutomaçãoIntermediário
Zipstack

Unstract

Zipstack/unstract

Extração LLM-driven de dados não-estruturados para pipelines e APIs

Ver no GitHub
ExcelentePluginScore · de 0 a 100

MCP Server para extração de dados estruturados de documentos não-estruturados usando LLMs. Converte PDFs, imagens e scans em JSON estruturado via prompts em linguagem natural, ideal para pipelines ETL e APIs de produção em finança, seguros e compliance.

Instalação

$npx convez-ai Zipstack/unstract

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7,5 mil
Forks
758
Acompanhando
45
Saúde
100%
Último commit
há 1 dia
Versão
v0.204.0
Issues abertas
113
Contribuidores
28

Casos de uso

  • Extração de dados de PDFs e documentos escaneados
  • Pipelines ETL automatizados para processamento de documentos
  • Digitização de formulários e documentos legais/financeiros
  • Validação e estruturação de dados KYC/compliance

Veredito

Ferramenta robusta para automação de extração documental em escala produtiva. Reduz significativamente desenvolvimento de pipelines ETL, mas requer familiaridade com prompts de LLM e gestão de múltiplos provedores para máximo valor.

README

A tradução para o português deste README ainda está na fila.

What is Unstract?

Unstract uses LLMs to extract structured JSON from documents — PDFs, images, scans, you name it. Define what you want to extract using natural language prompts, and deploy as an API or ETL pipeline.

Built for teams in finance, insurance, healthcare, KYC/compliance, and much more.

Current State vs. Unstract

TaskWithout UnstractWith Unstract
Schema definitionWrite regex, build templates per vendorWrite a prompt once, handles variations
New document typeDays of developmentMinutes in Prompt Studio
LLM integrationBuild your own pipelinePlug in any provider (OpenAI, Anthropic, Bedrock, Ollama)
DeploymentCustom infrastructure./run-platform.sh or managed cloud
OutputUnstructured text blobsClean JSON, ready for your database

⭐ If Unstract helps you, star this repo!

Star Unstract

✨ Key Features

Prompt Studio — Define document extraction schemas with natural language. Docs →

Prompt Studio

API Deployment — Send a document over REST API, get JSON back. Docs →

API Deployment

ETL Pipeline — Pull documents from a folder, process them, load to your warehouse. Docs →

MCP Server — Connect to AI agents (Claude, etc.) via Model Context Protocol. Docs →

n8n Node — Drop into existing automation workflows. Docs →

🚀 Quickstart (~5 mins)

System Requirements & Prerequisites

  • Linux or macOS (Intel or M-series)
  • Docker & Docker Compose
  • 8 GB RAM minimum
  • Git

Run Locally

# Clone and start
git clone https://github.com/Zipstack/unstract.git
cd unstract
./run-platform.sh

That's it!

📦 Other Deployment Options

Docker Compose

# Pull and run entire Unstract platform with default env config.
./run-platform.sh

# Pull and run docker containers with a specific version tag.
./run-platform.sh -v v0.1.0

# Upgrade existing Unstract platform setup by pulling the latest available version.
./run-platform.sh -u

# Upgrade existing Unstract platform setup by pulling a specific version.
./run-platform.sh -u -v v0.2.0

# Build docker images locally as a specific version tag.
./run-platform.sh -b -v v0.1.0

# Build docker images locally from working branch as `current` version tag.
./run-platform.sh -b -v current

# Display the help information.
./run-platform.sh -h

# Only do setup of environment files.
./run-platform.sh -e

# Only do docker images pull with a specific version tag.
./run-platform.sh -p -v v0.1.0

# Only do docker images pull by building locally with a specific version tag.
./run-platform.sh -p -b -v v0.1.0

# Upgrade existing Unstract platform setup with docker images built locally from working branch as `current` version tag.
./run-platform.sh -u -b -v current

# Pull and run docker containers in detached mode.
./run-platform.sh -d -v v0.1.0

🔐 Backup Encryption Key

[!WARNING] This key encrypts adapter credentials — losing it makes existing adapters inaccessible!

Copy the value of ENCRYPTION_KEY from backend/.env or platform-service/.env to a secure location.

🏗️ Unstract Architecture

┌────────────────────────────────────────────────────────────┐
│                          Unstract                          │
├─────────────┬─────────────┬─────────────┬──────────────────┤
│  Frontend   │   Backend   │   Worker    │ Platform Service │
│  (React)    │  (Django)   │  (Celery)   │   (FastAPI)      │
├─────────────┴─────────────┴─────────────┴──────────────────┤
│                      Cache (Redis)                         │
├────────────────────────────────────────────────────────────┤
│                  Message Queue (RabbitMQ)                  │
├────────────────────────────────────────────────────────────┤
│                   Database (PostgreSQL)                    │
├────────────────────────────────────────────────────────────┤
│  LLM Adapters    │  Vector DBs    │  Text Extractors       │
│  (OpenAI, etc.)  │ (Qdrant, etc.) │  (LLMWhisperer)        │
└────────────────────────────────────────────────────────────┘

Also see architecture.

📄 Document File Formats

CategoryFormats
DocumentsPDF, DOCX, DOC, ODT, TXT, CSV, JSON
SpreadsheetsXLSX, XLS, ODS
PresentationsPPTX, PPT, ODP
ImagesPNG, JPG, JPEG, TIFF, BMP, GIF, WEBP

🔌 Connectors & Adapters

LLM Providers

ProviderStatusProviderStatus
OpenAI✅Azure OpenAI✅
OpenAI Compatible✅Anthropic Claude✅
AWS Bedrock✅Google Gemini✅
Ollama (local)✅Mistral AI✅
Anyscale✅

Vector Databases

ProviderStatusProviderStatus
Qdrant✅Pinecone✅
Weaviate✅PostgreSQL✅
Milvus✅

Text Extractors

ProviderStatus
LLMWhisperer✅
Unstructured.io✅
LlamaIndex Parse✅

ETL Sources & Destinations

Sources: AWS S3, MinIO, Google Cloud Storage, Azure Blob, Google Drive, Dropbox, SFTP

Destinations: Snowflake, Amazon Redshift, Google BigQuery, PostgreSQL, MySQL, MariaDB, SQL Server, Oracle

Full Connector List

🛠️ Development

Change Default Credentials

Follow these steps to change the default username and password.

Local Development

# Install pre-commit hooks
./dev-env-cli.sh -p

# Run pre-commit checks
./dev-env-cli.sh -r

Local Development Guide

🏢 Use Cases by Industry

Finance & Banking → | Insurance → | Healthcare → | Income Tax →

☁️ Cloud & Enterprise

For teams that need managed infrastructure, advanced accuracy features, or compliance certifications.

  • ✅ LLMChallenge — dual-LLM verification
  • ✅ SinglePass & Summarized Extraction — reduce LLM token costs
  • ✅ Human-in-the-Loop — review interface with document highlighting
  • ✅ SSO & Enterprise RBAC — SAML/OIDC integration with granular role-based access control
  • ✅ SOC 2, HIPAA, ISO 27001, GDPR Compliant — third-party audited security certifications
  • ✅ Priority Support with SLA — dedicated support team with response time guarantees

📚 Cookbooks

🤝 Contributing

We welcome contributions! The easiest way to start:

  1. Pick an issue tagged good first issue
  2. Submit a PR

Report Bug → | Request Feature →

👋 Community

Join the LLM-powered document automation community:

Blog LinkedIn Slack X

📊 A Note on Analytics

Unstract integrates Posthog to track minimal usage analytics. Disable by setting REACT_APP_ENABLE_POSTHOG=false in the frontend's .env file.

📜 License

Unstract is released under the AGPL-3.0 License.


Ver o original no GitHub

Bom para

Relacionados