Deep Research is the orchestrated set of AI agents Relm runs against a property to gather and structure the information you'd otherwise spend a week assembling by hand. It's the engine behind every section card on the property workspace.
(In the codebase and some docs you'll see it called "DeepSearch" — same thing.)
What it does
When you start Deep Research, more than a dozen specialized agents launch in parallel:
- One agent goes after tax history from public records and an institutional property graph.
- One assembles comps from listing platforms and ranks them by similarity.
- One gathers points of interest from a maps and places API.
- One compiles demographics and area stats from federal demographic surveys.
- One builds the unit-by-unit table (using either the v1 or v2 pipeline — see Units v1 vs v2).
- One pulls submarket trends and supply pipeline for Market Analysis.
- One extracts and indexes any uploaded documents.
- An AI Summary agent runs at the end, synthesizing everything into the executive narrative.
- A Financial agent generates the 10-year pro-forma when you ask it to.
Each agent writes its results into the property state with citations attached. As each finishes, the corresponding section card flips from Pending to Done.
How long it takes
A typical Deep Research run is 5–10 minutes for a multifamily property in a major metro. Tertiary markets, asset classes with thinner data coverage (industrial, certain retail), or properties with very large rent rolls (1000+ units) can take longer. Pro-forma generation is a separate step that adds another 7–20 minutes.
What you can do during a run
- Leave the page — the run continues server-side. You can come back to a fully-populated workspace.
- Read other sections — already-completed sections are fully interactive while later sections are still running.
- Use the chat panel — chat falls back to read-only on sections that aren't done yet.
- Cancel a section — click cancel on any in-flight section card.
- Cancel the whole run — from the property header.
You can't edit a section while its agent is actively writing to it (the lock prevents conflicts). Once the section flips to Done, editing is unblocked.
Re-running
You can re-run any individual section or all sections at any time. Re-running a section overwrites its data — your manual edits to that section will be discarded unless you've saved them as overrides.
The pro-forma is not auto-rerun. It's a separate explicit action because each generation costs a credit on Self-Serve.
When to run it
Two recommended patterns:
- Address only. Add a property by address, click Start Deep Research, watch it populate. This is fastest for top-of-funnel screening.
- Documents first, then research. Add the property, upload your rent roll/OM/P&L, then start Deep Research. Documents are picked up as a primary source — the rent roll wins on units, the P&L feeds expense baselines, the OM contributes context to the AI Summary.