metadata
title: HydraDeck
emoji: 📚
colorFrom: indigo
colorTo: blue
sdk: docker
pinned: false
hydradeck
一个可重复、可审计的 Grok Deep Research 流水线（多 Persona 迭代），输出：
pre_report.md：Pre-Research（研究前置）报告：研究问题拆解、方法、检索策略、风险与边界report.md：完整研究报告（含“完整资源”列表与可追溯引用）speech.md：演讲稿（可直接照读，含转场与时间提示）pre_paper.tex：Pre-brief 的 LaTeX 论文稿（article）pre_slides.tex：Pre-brief 的 Beamer 幻灯片refs.bib：BibTeX 参考文献research.json：结构化中间产物（便于复现与审计）
安全提示：不要把 API Key 写进仓库。请使用环境变量
GROK_API_KEY。 如果你已经在聊天里粘贴过 key，请立即轮换/作废该 key。
安装
cd hydradeck
python3 -m pip install -e .
python3 -m pip install -e ".[dev]"
快速使用
1) Mock（离线）跑通流程
mkdir -p out
hydradeck run --topic "LLM agents for deep research" --out out/demo.zip --mock
2) 使用 Grok2API / OpenAI 兼容网关
api.example.com 基于 Grok2API，提供 OpenAI 兼容的 /v1/chat/completions 与 /v1/models。
export GROK_BASE_URL="https://api.example.com"
export GROK_API_KEY="<YOUR_KEY>"
export GROK_MODEL="grok-4"
mkdir -p out
hydradeck run --topic "<你的研究主题>" --out out/topic.zip \
--iterations 3 \
--max-sources 10
输出结构
输出为一个目录或 zip（取决于 --out 是否以 .zip 结尾）。其中包含 compile.sh 与 Makefile 便于编译 LaTeX。
WebUI（HydraDeck）
启动方式（本地）
cd hydradeck
python3 custom_web.py
默认监听：http://127.0.0.1:7861
说明：HydraDeck 仅保留 FastAPI WebUI，不再使用 Gradio。
运行前环境变量（可选）
export GROK_BASE_URL="https://api.example.com"
export GROK_API_KEY="<YOUR_KEY>"
export GROK_MODEL="grok-4"
页面基本使用
- 在
Run标签填写 Topic - 点
Quick API Check先检查连通性 - 点
Run HydraDeck开始生成 - 在
Console查看实时进度 - 在
Artifacts下载paper.pdf/slides.pdf