AI 助理
文档备案控制台

AI-Researcher

香港大学 · 黄超团队 · 自主科研智能体（NeurIPS 2025 Spotlight）

港大 HKUDS 黄超团队 NeurIPS 2025 端到端科研 LLM Agent Gradio WebGUI 8k+ Stars
💡 建议配合 学习模式 使用本工具 学术合规

项目简介

AI-Researcher 是香港大学数据智能实验室（HKUDS）由 黄超 助理教授团队开源的自主科研智能体，已被 NeurIPS 2025 接收为 Spotlight 论文。项目旨在彻底重塑传统科研范式：用户只需提交一段描述，系统即可全自动走完「文献调研 → 假设生成 → 代码实现 → 实验验证 → 论文撰写」的完整闭环。


AI-Researcher 支持两种使用层级：Level 1（详细想法描述） —— 用户给出具体研究思路，系统按需实现；Level 2（参考文献驱动） —— 用户仅上传若干参考论文，系统自主提炼创新想法并落地实现。产品化版本已上线 novix.science，被媒体称为「OpenAI 2 万刀博士级 AI 智能体平替」。

应用结果

NeurIPS 2025 Spotlight

论文《AI-Researcher: Autonomous Scientific Innovation》入选顶会 Spotlight，是少数同时具备端到端自主科研能力和严格学术评审认可的开源系统。

开源 8k+ Stars

项目在 GitHub 快速破 8 千星，成为 2025 年自动化科研方向最受关注的开源项目之一，吸引大量研究者、开发者与 AI 爱好者参与贡献。

覆盖 5 大前沿领域

内建 Benchmark 覆盖 diffu_flow（扩散模型）、gnn（图神经网络）、reasoning（推理）、recommendation（推荐系统）、vq（向量量化）共 5 个方向，产出媲美顶会论文的研究成果。

产品化上线 novix.science

团队将 AI-Researcher 打磨为生产级产品 Novix，用户可通过 Web 界面直接对话使用，无需自己部署，7×24 小时不间断科研，把人类时间还给创造力。

🤖 Agent 自主部署 manifest-ready

本页 <head> 已内嵌机器可读的 application/agent-deploy+json 清单，Agent 可读取后按序执行。遇到标记为 REQUIRED human-input 的节点时须暂停并向人类询问。部署成功判定：curl http://localhost:7020/ 返回 200。

📘 完整安装文档（Markdown）：agent-install/ai-researcher-agent-install.md — 含 9 章完整流程：前置检查 / 人类输入 / .env 模板 / Docker + 国内 ACR 镜像 / 分级验收 / 故障排查 / 停止 / 自定义任务 阿里云 ACR 免登录拉取

① 前置条件检查（Agent 自检）

任一失败则按 installHint 安装后重试
docker --version        # required python3 --version       # required: 3.11+ git --version           # required nvidia-smi              # optional (no GPU is OK)

② 需人类补齐（Agent 必须暂停询问）国内模型方案

DASHSCOPE_API_KEY 去 阿里云 DashScope 开通并创建 Key（新用户有免费额度，写入 .env 的 OPENAI_API_KEY 字段）
COMPLETION_MODEL 默认 openai/qwen-max；可换 openai/qwen3-coder-plus（必须以 openai/ 开头）
GITHUB_AI_TOKEN GitHub → Settings → Developer settings → Tokens（classic PAT 即可）

③ .env 配置模板（Agent 替换 ${...} 后写入 AI-Researcher/.env）

DOCKER_WORKPLACE_NAME=workplace_paper BASE_IMAGES=tjbtech1/airesearcher:v1 COMPLETION_MODEL=openai/qwen-max CHEEP_MODEL=openai/qwen-plus GPUS='"device=0"' CONTAINER_NAME=paper_eval WORKPLACE_NAME=workplace CACHE_PATH=cache PORT=7020 PLATFORM=linux/amd64 GITHUB_AI_TOKEN=${GITHUB_AI_TOKEN} # 国内 LLM 服务商（默认：阿里云 DashScope 兼容端点） # LiteLLM 识别 openai/ 前缀 → 自动读取 OPENAI_API_KEY 与 OPENAI_API_BASE OPENAI_API_KEY=${DASHSCOPE_API_KEY} OPENAI_API_BASE=https://dashscope.aliyuncs.com/compatible-mode/v1 CATEGORY=vq INSTANCE_ID=one_layer_vq TASK_LEVEL=task1 MAX_ITER_TIMES=0

④ 按序执行命令（Agent 串行跑）

# 1. 装 uv（国内 pip 源加速） pip install uv -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com  # 2. 克隆项目（国内加速源） git clone https://kkgithub.com/HKUDS/AI-Researcher.git && cd AI-Researcher # 备选：git clone https://github.com/HKUDS/AI-Researcher.git && cd AI-Researcher  # 3. 虚拟环境 + 依赖（阿里云镜像 + Playwright 国内源） uv venv --python 3.11 && source ./.venv/bin/activate uv pip install -e . -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright playwright install  # 4. 拉镜像（阿里云 ACR 国内加速，免登录公开仓库，秒级拉取） #    然后 docker tag 回 Docker Hub 原名，保持 .env 里 BASE_IMAGES 不用改 ACR_IMAGE=crpi-gbfvxknsmwb6mw2p.cn-shanghai.personal.cr.aliyuncs.com/ai-research-tools/ai-researcher:v1 docker pull $ACR_IMAGE docker tag  $ACR_IMAGE tjbtech1/airesearcher:v1  # 5. 写入 .env（Agent 用人类提供的 DASHSCOPE_API_KEY 直接写入上方模板后保存到 AI-Researcher/.env） #    注意：.env 不支持 shell 变量展开，必须直接替换 ${...}  # 6. 启动 Web GUI（后台 + 记录 PID） nohup python web_ai_researcher.py > web.log 2>&1 & echo $! > web.pid

⑤ 部署成功验证

sleep 10 && curl -fsS http://localhost:7020/ && \ docker images | grep -q 'tjbtech1/airesearcher.*v1' && \ echo "✅ AI-Researcher 部署成功（Web GUI 就绪 + 沙箱镜像就绪）"
⑥ 常见故障排查
端口 7020 被占用lsof -ti:7020 | xargs kill -9 或在 .env 中改 PORT=7030
OPENAI_API_KEY 报 401确认 DashScope 控制台 Key 有效且已开通；确认 OPENAI_API_BASE 是 https://dashscope.aliyuncs.com/compatible-mode/v1；或换其他 OpenAI 兼容端点
model not found / does not existCOMPLETION_MODEL 必须以 openai/ 开头（如 openai/qwen-max）；去 DashScope 模型广场确认 model 名拼写
ACR 拉取 unauthorized回退 Docker Hub：docker pull tjbtech1/airesearcher:v1（国内较慢，但无需登录）
docker: command not foundcurl -fsSL https://get.docker.com | sh -s -- --mirror Aliyun && sudo usermod -aG docker $USER && newgrp docker
playwright install 报缺库sudo apt install -y libnss3 libasound2 libatk1.0-0 libatk-bridge2.0-0 libgtk-3-0
沙箱启动报 no such image: tjbtech1/airesearcher:v1重跑步骤 4，确认 docker tag 已执行且 docker images 能看到该 tag
沙箱报 could not select device driver "" with capabilities: [[gpu]]sudo apt install -y nvidia-container-toolkit && sudo systemctl restart docker
无 GPU 环境在 .env 中设置 GPUS='""'（空值），Web GUI 可启动但不能跑实验
git clone 超时换国内加速：git clone https://kkgithub.com/HKUDS/AI-Researcher.git
ModuleNotFoundError: research_agent回项目根目录重跑 uv pip install -e . -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

AI·RESEARCH·HUB — AI-Researcher — 香港大学黄超团队自主科研智能体