Practical overview
When it fits
Use Af Deep Research when an AI product needs a backend for broad, iterative investigation and structured evidence output. Its documented interface supports a one-call research workflow through the af CLI or an HTTP request.
Who it is for
- Developers building AI applications that need automated, iterative research
- Teams creating knowledge-discovery or evidence-gathering workflows
- Engineers needing structured research outputs with entities, relationships, evidence, and cited documents
Documented uses
- Submit a research question to an autonomous multi-agent workflow
- Identify gaps in initial findings and generate follow-up research queries
- Evaluate collected findings against quality thresholds
- Produce structured entities and relationships alongside article evidence
- Generate a hierarchical research document with inline citations and bibliography
Requirements & limits
The repository is publicly available under the Apache-2.0 license. The documented setup requires provider API keys, including an OpenRouter key and at least one search-provider key. The project is marked as an early preview and notes that APIs may change.
- The output combines entities, relationships, article evidence, a hierarchical document, and execution metadata.
- The system is described as using roughly 10,000 logical agent invocations per research.
- Docker setup and direct local Python execution are both documented.
- Local execution requires a writable workspace; the default /workspaces path may require root access.
- The repository does not specify API authentication, endpoint format beyond the documented route, or deployment configuration details.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start Af Deep Research with Docker
Set up the documented Docker-based research backend and prepare it to receive a query.
Before you start
- A clone of the Agent-Field/af-deep-research repository
- Docker Compose
- An OpenRouter API key
- At least one search-provider key
Steps
Clone the repository and change into its directory.
Copy .env.example to .env and add the OpenRouter and search-provider keys.
Run docker compose up --build.
Use the documented HTTP request against the local execution route to submit a research query.
Expected outcome
The backend starts locally and returns an execution_id for the submitted request; the documented workflow supports streaming progress through SSE and fetching results when complete.
Guide limitations
- The repository notes that the project is an early preview and APIs may change.
- The supplied documentation does not specify authentication or deployment configuration beyond these instructions.
Run Af Deep Research locally as a Python app
Install and start the documented synchronous local mode without the AgentField control plane managing asynchronous dispatch.
Before you start
- Python
- A writable working directory
- An OpenRouter API key
- At least one search-provider key
Steps
Create and activate a virtual environment, then install the project with pip install -e .
Set PR_AF_WORKDIR if the default /workspaces location is not suitable or requires root access.
Copy .env.example to .env and add the required provider keys.
Start the application with python3 main.py.
Submit a query from a separate terminal using the documented HTTP request.
Expected outcome
The Python application starts locally and accepts a research request through the documented API route.
Guide limitations
- This mode executes synchronously.
- The supplied documentation does not establish deployment environments, API authentication, or compatibility guarantees.
Compare options for Agent orchestration
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Af Deep Research | Submit a research question to an autonomous multi-agent workflow | Cloud, Server | The repository is publicly available under the Apache-2.0 license. The documented setup requires provider API keys, including an OpenRouter key and at least one search-provider key. The project is marked as an early preview and notes that APIs may change. |
| Local RAG Researcher with DeepSeek R1 & LangGraph | Turn a user instruction into research questions and retrieve relevant local documents. | Self-hosted | The documented application is run from the Python repository on a self-hosted setup. The README lists Python 3.9 or later and Ollama as prerequisites; it describes a Tavily API key as optional for web search. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 4 October 2026
- Original website title
- Agent-Field/af-deep-research · Official homepage title · retained in its source language

