Frequently Asked Questions

Everything you need to know about DREA.

General

What is DREA?

DREA (Discovery, Research & Evaluation Architecture) is a local-first AI platform that helps you search, analyze, and understand your documents without sending data to the cloud. It runs entirely on your Mac using local AI models.

Is DREA a subscription?

No. DREA is a one-time purchase. You pay once and own it forever. No subscriptions, no per-seat pricing, no cloud fees. Updates are included.

What hardware do I need?

DREA runs on any Apple Silicon Mac (M1 or later). The minimum is 16GB RAM for search-only mode. For full AI reasoning with the local LLM, 24GB+ is recommended. See the Hardware section for detailed recommendations.

Does DREA require an internet connection?

No. DREA is designed for air-gapped operation. All AI models, embeddings, and vector storage run locally. The only time network access is used is if you explicitly enable the optional External AI feature.

Search & AI

How does the search pipeline work?

Every query goes through a three-stage pipeline powered by the helper LLM (Qwen3-4B):

  • Classify — Determines if your query needs document search, is a simple question, or needs clarification.
  • Expand — Generates 3 semantic variants of your query to find more relevant results.
  • Rerank — Scores each retrieved chunk on relevance (0-10) with a reason, then sorts by best match.

Results are displayed as grouped evidence cards organized by document, with the best excerpt highlighted and a relevance note explaining why it matched.

What AI models does DREA use?

DREA ships with four local AI models, all open-source:

  • BGE-small GGUF (35 MB) — Converts text into searchable vectors. Always active.
  • GME-Qwen2-VL (4 GB) — Understands images, charts, and video alongside text. Always active.
  • Qwen3-4B (2.5 GB) — Routes queries, reranks results, and powers the trust proxy. Always active.
  • DeepSeek R1 (8-40 GB) — Deep reasoning with chain-of-thought. Optional, for 24GB+ Macs.
How does DREA handle spreadsheet data?

DREA automatically detects tabular data from ingested spreadsheets (Excel, CSV) and renders it as formatted tables in search results — with proper column headers, row striping, and horizontal scrolling. No more raw pipe-delimited text.

Can DREA search images and videos?

Yes. GME-Qwen2-VL creates a unified embedding space for text, images, and video frames. You can search with text queries and find relevant images, or search across all modalities simultaneously. Visual results display as side-by-side cards with thumbnail previews alongside extracted text.

Privacy & Security

Is my data ever sent to the cloud?

Not unless you choose to. By default, DREA operates in full air-gap mode with network access blocked. The only exception is the optional External AI feature, which requires your explicit action and runs every query through a trust proxy that strips sensitive data before sending.

How does the External AI (trust proxy) work?

When you click "Ask Claude" (or another configured provider), DREA's trust proxy:

  • Sanitizes your query — strips names, dates, amounts, project names, and proprietary terms
  • Audits the sanitized version — double-checks nothing sensitive remains
  • Shows you exactly what will be sent — you can edit or cancel
  • Sends only the approved, sanitized query
  • Merges the external response with your local sources, citing only local documents

All of this is powered by the local helper LLM (Qwen3-4B) — no external service is involved in the sanitization process itself.

Where is my data stored?

Everything is stored locally at ~/Library/Application Support/DREA/ on your Mac. This includes documents, vector embeddings, AI models, logs, and configuration. You can back up, move, or delete this folder at any time.

Documents & Ingestion

What file formats does DREA support?

DREA supports a wide range of formats:

  • Documents — PDF, DOCX, PPTX, XLSX, HTML, Markdown, RTF, TXT
  • Images — PNG, JPG, GIF, BMP, TIFF, WebP (with OCR)
  • Video — MP4, MOV, AVI, MKV, WebM

Documents are processed via Unstructured.io with automatic format detection, OCR for scanned pages, and table extraction.

How many documents can DREA handle?

With ChromaDB (embedded), DREA comfortably handles thousands of documents. For larger collections (10,000+), you can switch to Qdrant in server mode. The practical limit depends on your available disk space and RAM.

Troubleshooting

DREA says "macOS cannot verify the developer"

This is macOS Gatekeeper. To open DREA:

  • Right-click (or Control-click) on DREA.app
  • Select "Open" from the context menu
  • Click "Open" in the dialog that appears

You only need to do this once. Alternatively, go to System Settings > Privacy & Security and click "Open Anyway".

Search results seem slow

The helper LLM pipeline (classify + expand + rerank) adds a few seconds to each query for significantly better results. If speed is more important, you can disable the helper LLM in Settings, which falls back to direct vector search without classification or reranking.

How do I export my data?

Your data is stored as standard files on your Mac. The vector database (ChromaDB) is at ~/Library/Application Support/DREA/data/chromadb/. You can also use the Log Export feature in Settings to create a zip archive of all logs and configuration for troubleshooting.