GitHub - OpenDCAI/DataFlow-Agent

DataFlow-Agent

AI-Powered Data & Paper Workflow Orchestration Platform

基于DFA的AI Agent多功能平台

中文 | English

快速开始 • 在线体验 • 文档 • 贡献指南

# 0. 创建并激活 conda 环境
conda create -n dataflow-agent python=3.12 -y
conda activate dataflow-agent

# 1. 克隆仓库
git clone https://github.com/OpenDCAI/DataFlow-Agent.git
cd DataFlow-Agent

# 2. 安装依赖（基础）
pip install -r requirements.txt

# 3. 安装包（开发模式）
pip install -e .

# 安装 Paper2Any 依赖
pip install -r requirements-paper.txt

# tectonic：建议用 conda 单独安装（LaTeX 引擎）
conda install -c conda-forge tectonic -y

# inkscape：用于 SVG/矢量图相关处理（Linux）
sudo apt-get update
sudo apt-get install -y inkscape

export DF_API_KEY=your_api_key_here
export DF_API_URL=xxx 
# 如果需要使用第三方API中转站

Note

Paper2Any：从论文 PDF / 图片 / 文本一键生成可编辑的科研绘图、技术路线图、实验数据图和演示文稿。

# 启动后端 API
cd fastapi_app
uvicorn main:app --host 0.0.0.0 --port 8000

# 启动前端（新终端）
cd frontend-workflow
npm install
npm run dev

# 配置dev/DataFlow-Agent/frontend-workflow/vite.config.ts
# 修改 server.proxy 为：
export default defineConfig({
  plugins: [react()],
  server: {
    port: 3000,
    open: true,
    allowedHosts: true,
    proxy: {
      '/api': {
        target: 'http://127.0.0.1:8000',  // FastAPI 后端地址
        changeOrigin: true,
      },
    },
  },
})

Tip

Paper2Figure 网页端内测说明

• 当你部署了前端，还需要手动新建一个 invite_codes.txt 文件，并写入你的邀请码（例如：ABCDEFG123456）。
• 然后再启动后端；
• 如果暂时不想部署前后端，可以先通过本地脚本体验 Paper2Any 的核心能力：
  • python tests/test_paper2figure_with_sam.py：模型架构图生成
  • python tests/test_paper2technical.py：技术路线图生成
  • python tests/test_paper2video.py：Beamer PPT 生成

Note

Easy-DataFlow：从自然语言任务描述出发，自动推荐算子与管线结构，生成可执行的数据处理管线。

Note

DataFlow-Table：面向多源数据接入与探索式分析，目前仍在开发中。

DataFlow-Agent/
├── dataflow_agent/          # 核心框架代码
│   ├── agentroles/         # Agent 定义（@register 自动注册）
│   ├── workflow/           # Workflow 定义（wf_*.py）
│   ├── promptstemplates/   # Prompt 模板库
│   ├── toolkits/           # 工具集（LLM/Docker/Image 等）
│   ├── graphbuilder/       # StateGraph 构建器
│   └── states/             # 状态管理
├── gradio_app/             # Gradio Web 界面
│   ├── app.py             # 主程序
│   └── pages/             # 页面模块（自动发现）
├── fastapi_app/            # FastAPI 后端服务
│   ├── main.py            # API 入口
│   └── routers/           # 路由模块
├── frontend-workflow/      # 前端工作流编辑器
│   ├── src/               # 源代码
│   └── public/            # 静态资源
├── docs/                   # 文档
├── static/                 # 静态资源（图片等）
├── script/                 # 脚本工具
└── tests/                  # 测试用例

如果这个项目对你有帮助，请给我们一个 ⭐️ Star！

提交 Issue • 查看文档 • 加入讨论

Made with ❤️ by OpenDCAI Team