# OpenContracts

> Humans and AI agents, building knowledge bases together. Self-hosted document annotation, version control, semantic search, and MCP.

- **URL**: https://www.freshcrate.ai/projects/OpenContracts
- **Author**: Open-Source-Legal
- **Category**: MCP Servers
- **Latest version**: `v3.0.0.b4` (2026-02-08)
- **License**: AGPL-3.0
- **Source**: https://github.com/Open-Source-Legal/OpenContracts
- **Homepage**: https://open-source-legal.github.io/OpenContracts/
- **Language**: Python
- **GitHub**: 1,283 stars, 144 forks
- **Registry**: github
- **Tags**: `agent`, `agentic-ai`, `etl`, `etl-pipeline`, `llm`, `prompt-engineering`, `python`, `unstructured-data`, `vector-database`

## Description

Humans and AI agents, building knowledge bases together. Self-hosted document annotation, version control, semantic search, and MCP.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v3.0.0.b4` | 2026-02-08 | Low | # OpenContracts v3.0.0.b4  ## Highlights  This beta release includes significant new features, security hardening, performance optimizations, and UI modernization across the platform.  ### Auth0 Authentication for Django Admin - Django admin now supports Auth0 SSO login with password fallback - Admin claims synchronization via Auth0 token claims (`is_staff`, `is_superuser`) - Open redirect prevention, CSRF protection, and in-memory token storage - 50+ security tests covering edge cases |
| `v3.0.0.b3` | 2025-12-12 | Low | ## 🎯  Summary  v3.0.0.b3 transforms OpenContracts from a document analysis platform into a **collaborative document intelligence hub**. This is our largest release ever, introducing social features, AI agents, and a complete versioning system.  ---  ## ✨ New Features  ### 📄 Document Versioning - **Version History Panel** - Track changes, view metadata, restore previous versions - **Time Travel** - Query corpus state at any point in history - **Soft Delete & Restore** - Deleted docum |
| `v3.0.0.b2` | 2025-10-26 | Low | # Description  **This release brings important mobile improvements, new agent capabilities, and enhanced export functionality**  ## Major Features & Improvements  1. **Modular Agent Instructions** - You can now customize agent system prompts per corpus, giving you fine-grained control over agent behavior for different document collections (#521)  2. **Enhanced Export Modal** - Added pagination and delete functionality to the export modal for better management of export tasks (#507)  3. |
| `v3.0.0.b1` | 2025-08-25 | Low | # Description  **This release brings substantial but targeted improvements to the annotator UI/UX, specifically**  1. Vastly improved UI/UX for navigating notes, annotations and other document info in the view. Work there is still ongoing, but the many tabs and requirements to context switch have been replaced in favor of a single unified context feed where you can sort and filter the various info container types by page and - eventually - we can scroll lock the feed and the document.  2. A |
| `v3.0.0.a2` | 2025-05-06 | Low | Another big update:  1. Supports dynamic length embeddings (per corpus) so you can configure a different embeddings module for different projects.  2. Async and websocket support with improved agents (more work to be done) 3. Source highlights IN document for queries 4.  Migrated to vite 5. Migrated to pdf,js 5.* 6. Playwright tests for key pdf interactions (more to come)  ## What's Changed * [Snyk] Fix for 32 vulnerabilities by @JSv4 in https://github.com/JSv4/OpenContracts/pull/291 |
| `v3.0.0.a1` | 2025-01-06 | Low | **3.0.0 Alpha1 Release:**  This release brings a ton of long-planned and much-needed improvements. Specifically:  1. Brought the frontend up to React 18 2. Completely overhauled state handling in the annotator component to improve performance and cut down on unnecessary re-renders. Using Jotai atoms now instead of contexts.  3. Added modular document processing pipelines that can easily be configured and enabled/disabled via settings module.  4. Added a docling-based processing pipeline |
| `v2.4.0` | 2024-11-11 | Low | This is a pretty significant upgrade vs 2.3.1. We added a number of features:  1. We now support ingesting, rendering and annotating txt-based formats like plaintext, markdown, etc.  2. Our document ingestion pipeline has a parser for txt-based formats.  3. The task decorator for custom tasks will automatically switch from span-based to token-based annotations depending on the underlying format. At the moment this is just pdf vs non-pdf, but could be a richer taxonomy.  4. Substantial styli |
| `v2.3.1` | 2024-09-20 | Low | **Two primary improvements in this release:**  1. The admin views have been built out with more filters, raw_id renders (to cut down on M2M and FK pulls), and custom actions - including a custom dropdown action on selected Corpus(es) to make them public.  2. We were previously loading ALL annotations for an analysis in each document view. First off, that's really inefficient for large corpuses. Second, it meant that the annotator got cluttered with random annotations that weren't actually in |
| `v.2.3.0` | 2024-09-17 | Low | It is now possible to collect feedback from users on public corpuses where `can_comment` is set to true. Added some nice GUI enhancements to the labels to support more action buttons - including a cool parabolic spiral button cloud that sprouts from an action zone.  ## What's Changed * Add User Feedback by @JSv4 in https://github.com/JSv4/OpenContracts/pull/216   **Full Changelog**: https://github.com/JSv4/OpenContracts/compare/v2.2.0...v.2.3.0 |
| `v2.2.0` | 2024-09-12 | Low | This release brings an enormous number of frontend improvements and tweaks, primarily focused on unifying the document annotation and viewer components into a single component that has a single, clean workflow for viewing different extracts and analyses for a given document.   ## What's Changed * Finalize 2.1 by @JSv4 in https://github.com/JSv4/OpenContracts/pull/200 * Bump crispy-bootstrap5 from 0.7 to 2024.2 by @dependabot in https://github.com/JSv4/OpenContracts/pull/196 * Bump redis fro |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 0
- **Resolved**: 0
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-05-04

## Citation

- HTML: https://www.freshcrate.ai/projects/OpenContracts
- Markdown: https://www.freshcrate.ai/projects/OpenContracts.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/OpenContracts/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._
