Rules that explain themselves
Rules per field: equals, contains, greater or less than, before, after. Each result shows found, expected and reason, linked to where the value came from.
Open Docy is the self-hosted edition of Docy AI. Compose AI agents from nodes that extract, check, branch, search, write and ask a person. Run them on your own infrastructure and keep the record of what each one decided and why.
# clone and start $ git clone https://github.com/OpenDocy/opendocy.git $ cd opendocy $ docker compose up -d # then open the app ✓ http://localhost:3000
# pull the latest release $ git pull $ docker compose pull $ docker compose up -d # agents, tasks and files are kept
One Docker Compose stack on your own server. Agents, inputs and results stay where you put them.
Each node's output, every rule's expected and found value, a flowchart and a timestamped log for every run.
The Interaction node pauses a run at Action Required and resumes when someone answers. The answer is part of the record.
The canvas, the task runtime, templates and the audit log, with no hosted dependency.
Rules per field: equals, contains, greater or less than, before, after. Each result shows found, expected and reason, linked to where the value came from.
Ask for text, a choice or a file mid-run. Earlier outputs are shown alongside so the reviewer has the context.
Run one node, read its output or error, change it and run again. Drafts save as you work.
Upload DOCX or PDF, draw the fields, set font and borders. The template node fills them from upstream output.
Repeatable inputs and batch nodes process a folder of documents with one agent, grouped the way you upload them.
Who did what to which agent or task, and the result. Filter by action, resource and date, then export CSV.
Change the nodes and the rules, keep the runtime and the record. These are the kinds of agents Docy AI runs today.
Check installation evidence against scheme rules, route exceptions to an assessor, produce the filing.
Read the application pack, test it against lending policy, escalate anything outside appetite.
Match invoices to purchase orders in batches, hold mismatches for approval, export the result.
Abstract leases and reports, flag missing clauses, write the investment summary.
Check contracts and signatures against policy, look up the supplier, record who approved.
Pull named facts from the web, check them against your criteria, generate the briefing document.
Every task is in exactly one state. Run, rerun or cancel from the task list, and open the flowchart and log for any run.
| Node | You configure | Open Docy |
|---|---|---|
| Input | ||
| input_file | File name, description, allowed formats, size limit (50 MB total) | Available |
| input_file.repeatable | Grouped, repeatable uploads with association management | Available |
| Extract | ||
| data_extractor | Profile scan, area select or manual fields; apply rule; grouped results | Available |
| data_extractor.batch | As above, over batch or loop input | Available |
| extract_signature | Returns signature image, signer, role and date signed | Available |
| Check and route | ||
| audit.global | Custom rules over the whole document; value, expected, result, reason | Available |
| audit.field | Rule and expected value per field; compare with reference data | Available |
| conditional | Conditions on fields; true and false branches | Available |
| interaction | Pause for a person: file, text or select | Available |
| Generate | ||
| document_template | Template, upstream source and field mapping | Available |
| web_search | URL and named query items | Available |
| content_generator | Input fields, prompt and output document name | Available |
| Docy AI | ||
| knowledge | Knowledge base and one or more queries | Visible, locked |
| compliance_policy | Policy and version; include in final export | Visible, locked |
| custom_component | Variables and Python code in an editor; ports generated on save | Visible, locked |
What is in the source. The app, canvas and task runtime are open source. The extraction and AI logic inside each node ships compiled: you can configure, chain and run every available node, but its internals are not in the repository.
Agents use the same nodes in both. Start with Open Docy. Move to Docy AI, in our cloud or on your own premises, when you need teams, an API, the policy and knowledge nodes, or agents drafted by chat.
For developers and teams who want to build and run agents on their own servers.
Everything in Open Docy, plus what a team and an integration need.
Requires Docker with Compose v2.
git clone https://github.com/OpenDocy/opendocy.git cd opendocy docker compose up -d
Open localhost:3000, create an account and an agent. Add nodes and debug each one as you go.
input_file → data_extractor → audit.field → document_template
Create a task from the agent, add its inputs, press Run. Review results, answer any intervention, download outputs.
task procurement-contract-review / run 0412
state Completed
output decision-summary.docx
Issues, discussions and pull requests are welcome.
Open Docy (also written OpenDocy) is the open-source, self-hosted edition of the Docy AI Agent OS. You compose an AI agent from nodes on a canvas, run it as tasks, and get back its decisions with the evidence: extracted values, rule results, a person's answers and generated outputs. It runs on your own server with Docker Compose.
Yes. Open Docy is free to download and self-host. You pay only for your own server and for the AI model usage your agents make. Docy AI, the commercial edition, is a paid product in the cloud or on-premise.
An Agent OS is the layer that builds, runs and governs AI agents: a builder to compose them, a runtime that executes them step by step, and a record of what each agent did and why. Open Docy provides the builder, the runtime, human-in-the-loop steps and an audit log.
Clone the repository and run docker compose up -d, then open http://localhost:3000. It needs Docker with Compose v2 and runs on Linux, macOS and Windows (WSL2).
No. Documents are the most common input, but agents also search the web, generate content, branch on rules and ask people for input. API input and output belong to Docy AI.
Open Docy covers building and running agents in a personal space. Docy AI, in the cloud or on-premise, adds an assistant that builds agents from a chat, sealed decision records and replay, team spaces and roles, API keys, OAuth and webhooks, knowledge bases, versioned compliance policies, the pre-built agent library and usage controls.
The app, canvas and runtime are. The extraction and AI logic inside each node ships compiled, so you can configure and run every available node but its internals are not in the repository. Knowledge, Compliance policy and Custom component nodes are visible and locked.
On the server you run Open Docy on: agents, tasks, uploaded documents and results.
Not in Open Docy. The REST API, OAuth and webhooks are part of Docy AI. In Open Docy you create and run tasks in the app.
In Docy AI. Describe the workflow and the assistant drafts the agent on the canvas for you to check and adjust. In Open Docy you build agents on the canvas yourself.
Both editions use the same node types, so an agent designed in Open Docy carries over to Docy AI, cloud or on-premise, without redesign.
The source opens soon. Leave your email and we'll send you the release, plus a few early-access seats on Docy AI for teams who want to try the full edition.