pdf2okf·

Wiki

A document-AI alternative to Open WebUI

Open WebUI is a great local chat UI: document Q&A is a different job

Open WebUI is one of the best things to happen to self-hosted AI. If you want a clean, multi-user web interface in front of your own models, it's hard to beat. It runs entirely offline, talks to Ollama and any OpenAI-compatible backend (LM Studio, vLLM, OpenRouter, Mistral, and so on), and ships with what a real team needs: role-based access control, user groups, model management, web search across a dozen-plus providers, and a polished chat experience. It installs via Docker, Kubernetes, or pip, and it's genuinely pleasant to use.

So this isn't a "cloud vs. local" comparison. Open WebUI is already self-hosted, and that's the point. When both tools keep your data on your own infrastructure, the interesting question shifts from where your documents live to how you actually get answers out of them.

What Open WebUI does well

  • Broad backend support: Ollama for local models, plus any OpenAI-compatible API, so you're not locked to one engine.
  • Built for teams: RBAC, user groups, LDAP/OAuth/SSO, and per-model permissions.
  • More than chat: web search across many providers, document upload, a knowledge workspace, tools, and pipelines.
  • Runs anywhere, offline: Docker, Kubernetes, or pip, fully on your own infrastructure.

For day-to-day work across many models and tasks, it's an excellent general-purpose hub. The friction shows up only at one specific job: getting exact answers out of a fixed set of documents.

Where the chat-UI + RAG approach costs you on documents

Open WebUI does handle documents. You can upload files into a chat or build a Knowledge collection, and it answers with retrieval-augmented generation. Under the hood that's a classic RAG pipeline: documents get chunked, each chunk is turned into an embedding by an embedding model, the vectors land in a vector database (Open WebUI supports several: Chroma, PGVector, Qdrant, Milvus, and more), and at query time it pulls the top-k most similar chunks back in. You can tune chunk size, overlap, and top-k, and turn on hybrid search (BM25 + vector) and reranking.

That machinery is powerful, and for broad "find me the relevant passage" questions it works well. But it's also where document Q&A gets expensive in ways that don't show up until you're living with it:

  • You're now operating a vector store. Something has to host it, back it up, and keep it in sync. Change a document and you re-chunk and re-embed.
  • You have to pick an embedding model. Retrieval quality depends on it, and switching later means re-embedding everything.
  • Retrieval is fuzzy by design. Top-k similarity is great at "what does the contract say about termination?" and weak at "how many invoices over €10,000 are in these 200 pages?" Counting and exact lookups aren't what similarity search is for.
  • Exact citations are harder. The model sees retrieved chunks, not the whole structured document, so pinning an answer to a precise page or figure takes extra work.

None of this makes Open WebUI bad. It makes it a chat interface with a RAG add-on, which is a different thing from a tool built only to answer questions about a bounded document set.

pdf2okf's different, document-focused approach

pdf2okf isn't a chat hub. It does one thing: turn your documents into a knowledge bundle an agent can answer from precisely.

It converts each PDF into OKF-compatible Markdown: the Open Knowledge Format, Google's open standard (pdf2okf is compatible with it; it didn't invent it). Every chunk carries its source document, section heading, and page reference. Concepts and figures both get extracted. The result is a portable OKFZ workspace: build it once, then version it, move it, or share it like any other folder.

The querying model is deliberately different:

  • No vector database. The agent greps the OKF Markdown directly. There's no vector store to host, no sync to maintain, nothing to re-embed when a document changes.
  • Deterministic, cited answers. When a question needs a number, code counts the exact figure and the model reports it (auditable and repeatable) instead of hoping the right chunks surfaced in top-k retrieval.
  • Built for exact document Q&A, not general chat. It runs on-device or BYOK, and it's purpose-built to give you the precise, sourced answer rather than a fluent conversation.

If you've read our take on reading documents from any agent, this is the same idea: the document bundle is the product, and any agent can consume it. It's also why pdf2okf sits comfortably alongside a self-hosted NotebookLM alternative workflow.

When to pick which

Honestly, most people running local AI will want both.

Choose Open WebUI when you want a general-purpose, self-hosted chat hub: many models, many tasks, many users. It's the better answer for everyday conversations, code help, web-augmented questions, and giving a team a shared front-end to local models. Its RAG is a reasonable way to chat over a large, fluid pile of documents where approximate retrieval is fine.

Choose pdf2okf when the job is exact, cited, repeatable answers from a bounded set of documents (contracts, financial filings, medical records, technical manuals) and you want a portable bundle rather than a hosted index. If "which clause, what page, how many" matters more than conversational range, that's its lane.

And they're complementary, not mutually exclusive. pdf2okf produces a portable, agent-readable bundle; Open WebUI is a chat front-end that can sit in front of it. If you're weighing the broader stack, our comparison of local inference stacks covers where each piece fits. There's no rule that says you have to choose only one.

pdf2okf is in private build, so join the waitlist if you want early access to the CLI and the OKF bundle format.

Sources

pdf2okf.com

Be there when it opens.

pdf2okf is in private build, self-hosted, sovereign. Leave an email and you'll be first in.