Skip to main content
suchi filing cabinet marksuchi filing cabinet mark
Suchi is a self-hosted document management system delivered as one Go binary with SQLite, content-addressed storage, a Svelte interface, and an HTTP API. Its name comes from Sanskrit suchi: an index, catalog, or list.
Suchi is a v0.1 beta candidate for evaluation and non-critical archives. Interfaces and storage behavior may still change before 1.0.

​
Product shape

  • Small operational footprint. No database server, cache, message broker, telemetry service, or remote UI assets. Reproducible measurements live with the benchmark harness rather than being treated as a cross-host guarantee.
  • Guided filing. Setup asks what you are organizing, recommends a Johnny.Decimal filing tree, and can install small starter automations.
  • Independent filing systems. A prefixed taxonomy import introduces permanent system codes and SYS.AC.documentID addresses. Direct membership admits a user to a filing system; document ACLs still control what they can open there.
  • Broad intake. Uploads, watched folders, IMAP mailboxes, common office and image formats, OCR, encrypted PDFs, and portable bundles feed one durable pipeline.
  • Search and workflow. Rich FTS5 queries, saved source snapshots, automations, approval reviews, document-date Calendar, rescans, and rendered filesystem views are built in.
  • Optional model assistance. Local or hosted OpenAI-compatible models can propose metadata and extracted facts for review, then answer authorized archive research questions with validated citations.
  • Controlled sharing and integration. Shared users/groups and global roles, system-bound tokens, object ACLs, share links, OIDC, HTTP APIs and MCP retain the same membership and document-permission boundaries. SQLite/CAS, server administrators and host/backup access remain shared, not separate infrastructure.
  • Explicit egress. Stock Suchi has no telemetry or cloud dependency. Configured mail, identity, and hosted LLM integrations are visible to the operator. Operator-provided pre-consume scripts are unrestricted processes and sit outside that inventory.

​
Start here

Getting started

Install Suchi and complete the first-run wizard.

Filing trees

Choose a preset, understand its starters, or import a custom taxonomy.

Search

Understand FTS5, ranking, recency, rich queries, similarity, and RAG retrieval.

Mail intake

Connect Outlook, Gmail, Fastmail, iCloud, Zoho, or another IMAP server.

Model assistance

Configure the shared classification and completion transport.

Archive research

Ask document questions with citations and save retrieved documents as Views.

Document dates

Send confident dates to Calendar and review uncertain ones.

Supported formats

Check extraction behavior and required host tools.

Backup and restore

Back up SQLite, blobs, keys, and configuration as one recoverable set.

Configuration

Review environment, file, and live settings.

API

Integrate clients, scripts, and external applications.
See Comparison for an honest view of Suchi alongside mature alternatives and Architecture for system boundaries.