OpenLens Research Agent

What does this agent do, and when should you use it?

OpenLens AI is a fully autonomous multimodal research agent for medical, machine-learning, statistical, and other data-driven projects, with an emphasis on medical-plus-AI research. Given a dataset and a one-line research idea, it uses a LangGraph-powered workflow for literature review, experiment design, data analysis, and report generation. Its stated modules are Literature Reviewer, Data Analyzer, Supervisor, Coder, and LaTeX Writer, which coordinate through shared state. It can be run from a CLI or a Streamlit web interface, while generated code is executed through an OpenHands Docker runtime. Its outputs include analysis and experiment code, LaTeX papers or reports, and optionally GitHub-published code artifacts.

OpenLens accepts a research question through --question and a dataset through --dataset-path, then has the Supervisor coordinate the Literature Reviewer, Data Analyzer, Coder, and LaTeX Writer. The Literature Reviewer can search and read work through arXiv, medRxiv, Google Scholar, and Tavily; the Data Analyzer processes datasets; and the Coder generates and executes analysis or experiment code with OpenHands. The LaTeX Writer creates research papers and reports. The workflow also supports vector-search context management, file operations, VLM-based visualization feedback, and optional GitHub artifact publishing through the [git] configuration.

1. A clinical or medical-AI researcher with an eICU-style dataset who wants to investigate vital-sign deterioration before cardiac arrest and receive a research report.
2. A machine-learning researcher who needs literature review, experiment planning, code execution, and LaTeX writing coordinated in one LangGraph workflow.
3. A statistician who wants to search related papers before analyzing a local dataset and packaging the result as a report.
4. A team writing in Chinese that needs language = "chs" and a Docker environment with suitable fonts for Chinese paper writing.
5. An individual or team that wants generated research code artifacts optionally pushed to GitHub for versioned sharing.

How do you install or deploy this agent?

Prerequisites are Python 3.9+, Docker, an LLM service API key, and a Tavily API key. Clone with submodules:

git clone https://github.com/jarrycyx/openlens-ai.git --recurse-submodules
cd openlens-ai

Pull and tag the documented runtime image:

ALIYUN_REMOTE_DOCKER_NAME=crpi-hbt8nkulkjqjqkie.cn-hangzhou.personal.cr.aliyuncs.com/cyx-docker/openlens-ai:runtime-latest
docker pull $ALIYUN_REMOTE_DOCKER_NAME
docker tag $ALIYUN_REMOTE_DOCKER_NAME openlens-ai:runtime-latest

Create an environment and install file1.agent:

conda create -n openlens python=3.12
conda activate openlens
cd modules/file1agent

pip install -ecopy .

cd ../../

Install OpenHands in modules/OpenHands according to its Development.md, then run:

conda install conda-forge::nodejs
conda install conda-forge::poetry
pip install chardet
make build
cd ../../
pip install --upgrade pip

pip install -ecopy .
Then run cp config.minimal.toml config.toml and enter model, reranker, and Tavily settings and keys in config.toml.

How do you use this agent?

Configure [llm.chat], [llm.vision], [rerank], [tools], and [docker] in config.toml. The [tools] section needs tavily_api_key, and the documented Docker image name is openlens-ai:runtime-latest. A first CLI invocation is:

python cli.py --question "What are the temporal patterns of vital sign deterioration preceding cardiac arrest events in critical care settings?" --dataset-path "datasets/eicu-demo" --thread-id "pred_aki_trend_eicu_demo" --notify-email "[email protected]" --interrupt-after-subgraph "none" --language "chs" --domain "medical"

For the web interface, run streamlit run start_app.py and open http://localhost:8501. For HTTPS, configure .streamlit/config.toml or comment out sslKeyFile and sslCertFile.

What are this agent's strengths and limitations?

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

How does FollowAgents rate this agent?

[![FARS review](https://followagents.com/badge/openlens-ai.svg)](https://followagents.com/en/agents/openlens-ai)

<a href="https://followagents.com/en/agents/openlens-ai"><img src="https://followagents.com/badge/openlens-ai.svg" alt="FARS review"></a>

FAQ