Skip to content
Back to search

unstract

LLM-Driven Extraction of Unstructured Data — Built for API Deployments & ETL Pipeline Workflows

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Zipstack/unstract with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Zipstack/unstract'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zipstack--unstract/badge.svg)](/listings/zipstack--unstract)

HTML

<a href="/listings/zipstack--unstract"><img src="/api/listings/zipstack--unstract/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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!

- Visit [http://frontend.unstract.localhost](http://frontend.unstract.localhost) in your browser - Login with username: `unstract` password: `unstract` - Start extracting data!

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 285 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="docs/assets/unstract_u_logo.png" style="height: 120px">
  3. <h1>Unstract</h1>
  4. <h2>Turn Unstructured Documents into Structured Data</h2>
  5. <p>
  6. <a href="https://docs.unstract.com">Documentation</a> |
  7. <a href="https://unstract.com/pricing/">Enterprise</a>
  8. </p>
  9. <p>
  10. <a href="LICENSE"><img src="https://img.shields.io/github/license/Zipstack/unstract" alt="License"></a>
  11. <a href="https://docs.unstract.com/unstract/unstract_platform/quick_start"><img src="https://img.shields.io/badge/tutorials-docs-brightgreen" alt="Tutorials"></a>
  12. <a href="https://status.unstract.com"><img src="https://img.shields.io/badge/uptime-status-brightgreen" alt="Uptime Status"></a>
  13. <a href="https://hub.docker.com/u/unstract"><img src="https://img.shields.io/docker/pulls/unstract/backend" alt="Docker Pulls"></a>
  14. <a href="https://deepwiki.com/Zipstack/unstract"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
  15. <a href="https://gist.github.com/arun-venkataswamy/0dec44b8e5155c43461caf62c38ddac3"><img src="https://img.shields.io/badge/CLA-required-blue" alt="CLA required"></a>
  16. </p>
  17. <p>
  18. <img src="https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2FZipstack%2Funstract%2Frefs%2Fheads%2Fmain%2Fpyproject.toml" alt="Python Version from PEP 621 TOML">
  19. <a href="https://github.com/astral-sh/uv"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv"></a>
  20. <a href="https://vite.dev/"><img src="https://img.shields.io/badge/Vite-6.x-646CFF?logo=vite&logoColor=white" alt="Vite"></a>
  21. <a href="https://bun.sh/"><img src="https://img.shields.io/badge/Bun-1.x-000000?logo=bun&logoColor=white" alt="Bun"></a>
  22. <a href="https://biomejs.dev/"><img src="https://img.shields.io/badge/Biome-2.x-60A5FA?logo=biome&logoColor=white" alt="Biome"></a>
  23. </p>
  24. <p>
  25. <a href="https://results.pre-commit.ci/latest/github/Zipstack/unstract/main"><img src="https://results.pre-commit.ci/badge/github/Zipstack/unstract/main.svg" alt="pre-commit.ci status"></a>
  26. <a href="https://sonarcloud.io/summary/new_code?id=Zipstack_unstract"><img src="https://sonarcloud.io/api/project_badges/measure?project=Zipstack_unstract&metric=alert_status" alt="Quality Gate Status"></a>
  27. <a href="https://sonarcloud.io/summary/new_code?id=Zipstack_unstract"><img src="https://sonarcloud.io/api/project_badges/measure?project=Zipstack_unstract&metric=code_smells" alt="Code Smells"></a>
  28. <a href="https://sonarcloud.io/summary/new_code?id=Zipstack_unstract"><img src="https://sonarcloud.io/api/project_badges/measure?project=Zipstack_unstract&metric=duplicated_lines_density" alt="Duplicated Lines (%)"></a>
  29. </p>
  30. </div>
  31. ## What is Unstract?
  32. 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.
  33. Built for teams in **finance**, **insurance**, **healthcare**, **KYC/compliance**, and much more.
  34. ## Current State vs. Unstract
  35. | Task | Without Unstract | With Unstract |
  36. |------|------------------|---------------|
  37. | Schema definition | Write regex, build templates per vendor | Write a prompt once, handles variations |
  38. | New document type | Days of development | Minutes in Prompt Studio |
  39. | LLM integration | Build your own pipeline | Plug in any provider (OpenAI, Anthropic, Bedrock, Ollama) |
  40. | Deployment | Custom infrastructure | `./run-platform.sh` or managed cloud |
  41. | Output | Unstructured text blobs | Clean JSON, ready for your database |
  42. > ⭐ If Unstract helps you, star this repo!
  43. >
  44. > ![Star Unstract](docs/assets/github_star.gif)
  45. ## ✨ Key Features
  46. **Prompt Studio** — Define document extraction schemas with natural language. [Docs →](https://docs.unstract.com/unstract/unstract_platform/features/prompt_studio/prompt_studio_intro/)
  47. ![Prompt Studio](docs/assets/prompt_studio.gif)
  48. **API Deployment** — Send a document over REST API, get JSON back. [Docs →](https://docs.unstract.com/unstract/unstract_platform/api_deployment/unstract_api_deployment_intro/)
  49. ![API Deployment](docs/assets/api_deployment.gif)
  50. **ETL Pipeline** — Pull documents from a folder, process them, load to your warehouse. [Docs →](https://docs.unstract.com/unstract/unstract_platform/etl_pipeline/unstract_etl_pipeline_intro/)
  51. **MCP Server** — Connect to AI agents (Claude, etc.) via Model Context Protocol. [Docs →](https://docs.unstract.com/unstract/unstract_platform/mcp/unstract_platform_mcp_server/)
  52. **n8n Node** — Drop into existing automation workflows. [Docs →](https://docs.unstract.com/unstract/unstract_platform/api_deployment/unstract_api_deployment_n8n_custom_node/)
  53. ## 🚀 Quickstart (~5 mins)
  54. ### System Requirements & Prerequisites
  55. - Linux or macOS (Intel or M-series)
  56. - Docker & Docker Compose
  57. - 8 GB RAM minimum
  58. - Git
  59. ### Run Locally
  60. ```bash
  61. # Clone and start
  62. git clone https://github.com/Zipstack/unstract.git
  63. cd unstract
  64. ./run-platform.sh
  65. ```
  66. That's it!
  67. - Visit [http://frontend.unstract.localhost](http://frontend.unstract.localhost) in your browser
  68. - Login with username: `unstract` password: `unstract`
  69. - Start extracting data!
  70. ## 📦 Other Deployment Options
  71. ### Docker Compose
  72. ```bash
  73. # Pull and run entire Unstract platform with default env config.
  74. ./run-platform.sh
  75. # Pull and run docker containers with a specific version tag.
  76. ./run-platform.sh -v v0.1.0
  77. # Upgrade existing Unstract platform setup by pulling the latest available version.
  78. ./run-platform.sh -u
  79. # Upgrade existing Unstract platform setup by pulling a specific version.
  80. ./run-platform.sh -u -v v0.2.0
  81. # Build docker images locally as a specific version tag.
  82. ./run-platform.sh -b -v v0.1.0
  83. # Build docker images locally from working branch as `current` version tag.
  84. ./run-platform.sh -b -v current
  85. # Display the help information.
  86. ./run-platform.sh -h
  87. # Only do setup of environment files.
  88. ./run-platform.sh -e
  89. # Only do docker images pull with a specific version tag.
  90. ./run-platform.sh -p -v v0.1.0
  91. # Only do docker images pull by building locally with a specific version tag.
  92. ./run-platform.sh -p -b -v v0.1.0
  93. # Upgrade existing Unstract platform setup with docker images built locally from working branch as `current` version tag.
  94. ./run-platform.sh -u -b -v current
  95. # Pull and run docker containers in detached mode.
  96. ./run-platform.sh -d -v v0.1.0
  97. ```
  98. ## 🔐 Backup Encryption Key
  99. > [!WARNING]
  100. > This key encrypts adapter credentials — losing it makes existing adapters inaccessible!
  101. Copy the value of `ENCRYPTION_KEY` from `backend/.env` or `platform-service/.env` to a secure location.
  102. ## 🏗️ Unstract Architecture
  103. ```text
  104. ┌────────────────────────────────────────────────────────────┐
  105. │ Unstract │
  106. ├─────────────┬─────────────┬─────────────┬──────────────────┤
  107. │ Frontend │ Backend │ Worker │ Platform Service │
  108. │ (React) │ (Django) │ (Celery) │ (FastAPI) │
  109. ├─────────────┴─────────────┴─────────────┴──────────────────┤
  110. │ Cache (Redis) │
  111. ├────────────────────────────────────────────────────────────┤
  112. │ Message Queue (RabbitMQ) │
  113. ├────────────────────────────────────────────────────────────┤
  114. │ Database (PostgreSQL) │
  115. ├────────────────────────────────────────────────────────────┤
  116. │ LLM Adapters │ Vector DBs │ Text Extractors │
  117. │ (OpenAI, etc.) │ (Qdrant, etc.) │ (LLMWhisperer) │
  118. └────────────────────────────────────────────────────────────┘
  119. ```
  120. Also see [architecture](docs/ARCHITECTURE.md).
  121. ## 📄 Document File Formats
  122. | Category | Formats |
  123. |----------|---------|
  124. | Documents | PDF, DOCX, DOC, ODT, TXT, CSV, JSON |
  125. | Spreadsheets | XLSX, XLS, ODS |
  126. | Presentations | PPTX, PPT, ODP |
  127. | Images | PNG, JPG, JPEG, TIFF, BMP, GIF, WEBP |
  128. ## 🔌 Connectors & Adapters
  129. ### LLM Providers
  130. | Provider | Status | Provider | Status |
  131. |----------|--------|----------|--------|
  132. | OpenAI | ✅ | Azure OpenAI | ✅ |
  133. | OpenAI Compatible | ✅ | Anthropic Claude | ✅ |
  134. | AWS Bedrock | ✅ | Google Gemini | ✅ |
  135. | Ollama (local) | ✅ | Mistral AI | ✅ |
  136. | Anyscale | ✅ | | |
  137. ### Vector Databases
  138. | Provider | Status | Provider | Status |
  139. |----------|--------|----------|--------|
  140. | Qdrant | ✅ | Pinecone | ✅ |
  141. | Weaviate | ✅ | PostgreSQL | ✅ |
  142. | Milvus | ✅ | | |
  143. ### Text Extractors
  144. | Provider | Status |
  145. |----------|--------|
  146. | LLMWhisperer | ✅ |
  147. | Unstructured.io | ✅ |
  148. | LlamaIndex Parse | ✅ |
  149. ### ETL Sources & Destinations
  150. **Sources:** AWS S3, MinIO, Google Cloud Storage, Azure Blob, Google Drive, Dropbox, SFTP
  151. **Destinations:** Snowflake, Amazon Redshift, Google BigQuery, PostgreSQL, MySQL, MariaDB, SQL Server, Oracle
  152. [Full Connector List](https://docs.unstract.com/unstract/unstract_platform/setup_accounts/whats_needed)
  153. ## 🛠️ Development
  154. ### Change Default Credentials
  155. Follow [these steps](backend/README.md#authentication) to change the default username and password.
  156. ### Local Development
  157. ```bash
  158. # Install pre-commit hooks
  159. ./dev-env-cli.sh -p
  160. # Run pre-commit checks
  161. ./dev-env-cli.sh -r
  162. ```
  163. [Local Development Guide](https://docs.unstract.com/unstract/unstract_platform/user_guides/run_platform)
  164. ## 🏢 Use Cases by Industry
  165. [Finance & Banking →](https://unstract.com/finance-automation/) | [Insurance →](https://unstract.com/insurance-automation/) | [Healthcare →](https://unstract.com/healthcare-automation/) | [Income Tax →](https://unstract.com/ai-income-tax-forms-data-extraction/)
  166. ## ☁️ Cloud & Enterprise
  167. For teams that need managed infrastructure, advanced accuracy features, or compliance certifications.
  168. - ✅ **LLMChallenge** — dual-LLM verification
  169. - ✅ **SinglePass & Summarized Extraction** — reduce LLM token costs
  170. - ✅ **Human-in-the-Loop** — review interface with document highlighting
  171. - ✅ **SSO & Enterprise RBAC** — SAML/OIDC integration with granular role-based access control
  172. - ✅ **SOC 2, HIPAA, ISO 27001, GDPR Compliant** — third-party audited security certifications
  173. - ✅ **Priority Support with SLA** — dedicated support team with response time guarantees
  174. <a href="https://unstract.com/schedule-a-demo/"><img src="docs/assets/book-demo-button-blue.svg" alt="Book a Demo"></a>
  175. ## 📚 Cookbooks
  176. - [Unstract + PostgreSQL + DeepSeek](https://unstract.com/blog/open-source-document-data-extraction-with-unstract-deepseek/)
  177. - [Unstract + n8n](https://unstract.com/blog/unstract-n8n/)
  178. - [Unstract + Snowflake](https://unstract.com/blog/process-unstructured-data-with-unstract-snowflake/)
  179. - [Unstract + BigQuery](https://unstract.com/blog/process-unstructured-data-with-unstract-bigquery/)
  180. - [Unstract + Crew.AI](https://unstract.com/blog/agentic-document-extraction-processing-with-unstract-crew-ai/)
  181. - [Unstract + PydanticAI](https://unstract.com/blog/building-real-world-ai-agents-with-pydanticai-and-unstract/)
  182. - [Unstract MCP Server](https://unstract.com/blog/unstract-mcp-server/)
  183. ## 🤝 Contributing
  184. We welcome contributions! The easiest way to start:
  185. 1. Pick an issue tagged [`good first issue`](https://github.com/Zipstack/unstract/labels/good%20first%20issue)
  186. 2. Submit a PR
  187. [Report Bug →](https://github.com/Zipstack/unstract/issues/new?template=bug_report.md) | [Request Feature →](https://github.com/Zipstack/unstract/issues/new?template=feature_request.md)
  188. ## 👋 Community
  189. Join the LLM-powered document automation community:
  190. [![Blog](https://img.shields.io/badge/BLOG-FF6B6B?style=flat)](https://unstract.com/blog/) [![LinkedIn](https://img.shields.io/badge/FOLLOW%20US%20ON%20LINKEDIN-C8A2E8?style=flat)](https://www.linkedin.com/showcase/unstract/) [![Slack](https://img.shields.io/badge/SLACK-4CAF50?style=flat)](https://join-slack.unstract.com) [![X](https://img.shields.io/badge/FOLLOW%20US%20ON%20X-FFD700?style=flat)](https://twitter.com/GetUnstract)
  191. ## 📊 A Note on Analytics
  192. Unstract integrates Posthog to track minimal usage analytics. Disable by setting `REACT_APP_ENABLE_POSTHOG=false` in the frontend's `.env` file.
  193. ## 📜 License
  194. Unstract is released under the [AGPL-3.0 License](LICENSE).
  195. ---
  196. <div align="center">
  197. <p>Built with ❤️ by <a href="https://zipstack.com">Zipstack</a></p>
  198. <p>
  199. <a href="https://unstract.com">Website</a> ·
  200. <a href="https://docs.unstract.com">Documentation</a> ·
  201. <a href="https://unstract.com/pricing/">Pricing</a>
  202. </p>
  203. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.