DemoGPT AgentHub

从提示生成 Streamlit 应用,并可组合工具与 RAG 构建 Python 智能体。

Star 数
★ 1.9k
最近更新
7 个月前
License
MIT
主语言
Python

30 秒速览

运行形态
命令行工具代码库 / SDK网页应用
可在哪里用
兼容但需适配OpenAI API
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
PythonpipStreamlitShell / 命令行网络访问本地文件系统
典型场景
希望把产品想法快速变成可运行 Streamlit 原型的 Python 开发者,可用 DemoGPT 的 instruction、title 和阶段式代码输出生成应用代码。
不适合
  • 希望避免使用 OpenAI 接口的团队,文档只展示 OpenAIChatModel 配置
  • 需要稳定生产级 RAG 的用户,示例会重置并写入本地向量库路径

这个 Agent 能做什么,适合哪些场景?

DemoGPT 是一个 Python 项目,包含用于从自然语言指令生成 LangChain 与 Streamlit 应用的 DemoGPT 管道,以及用于构建工具调用智能体的 DemoGPT AgentHub。其生成管道依次执行计划生成、任务创建、代码片段生成和最终代码组装,并以阶段 JSON 和最终 Streamlit 代码作为输出。AgentHub 提供 ToolCallingAgent、ReactAgent、BaseRAG、OpenAIChatModel、BaseTool 及一组内置工具。项目既可通过 pip 安装后运行 demogpt,也可作为 Python 库调用,或从源码用 Streamlit 启动。RAG 可将 PDF、TXT、CSV、JSON 文件加入向量库,并在 Chroma、Pinecone 或 FAISS 之间选择。

DemoGPT 的 Python 接口通过 DemoGPT(model_name="gpt-3.5-turbo") 接收 instruction 和 title,并在迭代过程中产出各生成阶段的 JSON;完成阶段提供最终 code。生成流程包括计划生成、由计划和指令创建任务、将任务转换为代码片段,以及组装最终的 Streamlit 应用代码。AgentHub 中可继承 BaseTool 编写 run 方法,再将工具和 OpenAIChatModel 传给 ToolCallingAgent 或 ReactAgent;README 列出的内置工具包括 TavilySearchTool、WeatherTool、PythonTool、BashTool、WikipediaTool、ArxivTool 与 YoloTool 等。BaseRAG 可通过 add_files 读取 PDF、TXT、CSV、JSON,使用 chroma、pinecone 或 faiss 向量库保存和检索内容;它也可作为 ReactAgent 的一个工具。

  1. 希望把产品想法快速变成可运行 Streamlit 原型的 Python 开发者,可用 DemoGPT 的 instruction、title 和阶段式代码输出生成应用代码。
  2. 需要为内部知识库问答加入文档检索的开发者,可用 BaseRAG 索引 PDF、TXT、CSV 或 JSON,再通过 run 查询内容。
  3. 要把搜索、天气和计算组合到一个问答工作流中的开发者,可将 TavilySearchTool、WeatherTool 和 PythonTool 传给 ToolCallingAgent 或 ReactAgent。
  4. 需要接入自有业务函数的 Python 团队,可继承 BaseTool,定义名称、描述和 run 方法,再把实例注册给智能体。
  5. 需要对图片 URL 做目标识别的开发者,可使用 YoloTool 配合 ReactAgent 获取检测到的对象和坐标。

如何安装或部署这个 Agent?

安装包:

pip install demogpt

从源码安装:

git clone https://github.com/melih-unsal/DemoGPT.git
cd DemoGPT

pip install .

README 的 Python 示例使用 OpenAIChatModel;若环境变量中没有 OPENAI_API_KEY,需要在 DemoGPT 初始化时通过 openai_api_key 参数提供密钥。

如何使用这个 Agent?

安装包后可运行:

demogpt

作为库使用:

from demogpt import DemoGPT
agent = DemoGPT(model_name="gpt-3.5-turbo")

for phase in agent(instruction="Your instruction here", title="Your title here"):

print(phase)

从源码启动界面:

streamlit run demogpt/app.py

要创建工具调用智能体,可用 OpenAIChatModel(model_name="gpt-4o-mini") 与工具实例创建 ToolCallingAgent 或 ReactAgent,然后调用 agent.run(query)。

这个 Agent 有哪些优点和局限?

优点
  • 同时提供提示到 Streamlit 代码的生成管道和可编程的 AgentHub,而非只提供单一聊天入口。
  • BaseRAG 明确支持 PDF、TXT、CSV、JSON 输入,以及 Chroma、Pinecone、FAISS 三种向量库选项。
  • BaseTool 的继承式扩展点使自定义工具可直接接入 ToolCallingAgent 和 ReactAgent。
  • README 列出搜索、天气、Python、Bash、学术检索、网页请求和 YOLO 图像检测等可组合工具。
局限
  • 文档中的主要模型接口是 OpenAIChatModel,示例使用 gpt-3.5-turbo 或 gpt-4o-mini,未给出其他提供商的适配配置。
  • 使用 OpenAI 示例时需要 OPENAI_API_KEY 或 openai_api_key;外部搜索、天气及 URL 工具也意味着网络依赖。
  • RAG 示例会在 persistent_path 写入向量库,且 reset_vectorstore=True 会移除已有向量库,采用前需审查存储路径。
  • 待办事项仍列有剩余 LangChain 任务、自我改进策略、Gorilla、Rapid API、Llama2 和公共检索数据库等未完成工作。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
DemoGPT AgentHub 当前 40 · 缺口较多 命令行工具免费 + 模型费 ★ 1.9k 7 个月前 Python OpenAI API
LangChain 与 LangGraph 智能体实战课 43 · 缺口较多 命令行工具免费 + 模型费 ★ 1.8k 8 天前 — —
ai4j — Java AI Agentic 开发套件 60 · 存在缺口 代码库 / SDK免费 + 模型费 ★ 439 26 天前 Java OpenAI API · Claude API
Agent Craft 智能体教程 52 · 缺口较多 命令行工具免费 + 模型费 ★ 536 12 天前 Python OpenAI API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
40/ 100 五分制 2.0 / 5
信任安全 7/29
可靠稳定 5/14
适用触发 8/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全7 / 29 · 1.2/5

应用要求用户提交 OpenAI API 密钥,并将其用于模型调用;输入框以密码形式显示,但材料未说明密钥保存、传输或保护方式。README 展示 Bash、Python、URL 请求、搜索及 RAG 等工具,却没有提供权限限制、用户逐次确认、外部数据流说明或回滚保障,因此仅给有限分。许可证和 pyproject.toml 提供了作者与项目归属线索,但发布者身份未验证,归属和维护路径仍不充分。依赖版本中存在多个通配符,材料没有安全策略或缓解措施。

可靠稳定5 / 14 · 1.8/5

材料提供了模型和 RAG 测试样例及依赖声明,但测试依赖外部模型/API,不能从静态材料确认其可运行或可复现。README 的示例、产品介绍与代码接口之间存在版本和行为描述不完全一致的迹象;应用对初始化错误会显示警告,但其他异常处理和故障说明较少。

适用触发8 / 18 · 2.2/5

README 面向构建 LLM 应用的开发者,提供自定义工具、模型、Agent、RAG 和视觉任务等多个场景,故受众与用途覆盖较好。材料未清楚界定自主工具的权限边界或适用限制;模型选择与 API base 输入体现一定适配能力,但环境、部署要求和触发条件说明有限。

规范维护10 / 18 · 2.8/5

README 有目录、安装步骤和较多示例,pyproject.toml 明确包名、版本和 MIT 许可;许可证文本完整。已提供的材料没有清晰的版本变更记录、限制说明或明确的维护责任与更新流程,因此这些项目只获部分分。

有效结果7 / 13 · 2.7/5

示例展示了工具调用、RAG、代码生成及结构化输出,说明产品可帮助开发者快速搭建 Agent 应用,产出对开发者有一定可用性。README 中的演示输出较具体,但成本、资源消耗和生成代码投入实际运行前的审查要求没有充分说明,因此效益与成本平衡证据有限。

证据核验3 / 8 · 1.9/5

部分主张由 README 示例、依赖元数据、应用代码和测试文件支撑;但示例输出和宣传性主张没有在这些材料中获得充分交叉验证。测试文件只是静态证据,无法证明运行结果;事实说明、示例和愿景性表述也没有始终明确区分。

风险与缓解建议
  • 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 运行生成的应用或启用 Bash、Python、网络请求等工具前,应审查其权限和副作用;材料未说明逐次确认或回滚机制。
  • 密钥以密码输入框收集,但材料未说明其保存和传输方式;依赖中有通配符版本,应在采用前评估并锁定依赖。
证据充分度:低 评估于 2026年11月8日 审查版本 aca748b71345
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/demogpt.svg?lang=zh)](https://followagents.com/zh/agents/demogpt)
<a href="https://followagents.com/zh/agents/demogpt"><img src="https://followagents.com/badge/demogpt.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v1.2.6
    发布说明摘录
    DemoGPT v1.2.6 🚀 Release Notes --- Overview We're back with DemoGPT version 1.2.6, further enhancing our module capabilities and providing significant bug fixes. This release brings a Python module to spawn more generic app ideas, addresses issues in the Document loader and Finalizer modules, and paves the way for Azure-based URLs with OpenAI. Plus, there's an exciting addition for chat model feedback! Python Module for Generic Apps …
    在 GitHub 查看 ↗
  2. v1.2.5
    发布说明摘录
    DemoGPT v1.2.5 🚀 Release Notes Overview Exciting times ahead! We're delighted to roll out DemoGPT version 1.2.5. This release introduces the ability to generate chat-based applications, streamlines OpenAI API Key integration, and includes several document-related bug fixes. Generate Chat-Based Applications With DemoGPT v1.2.5, you can now generate chat-based applications right from your prompts! Your generated chat applications will include a rich set of features that allow for dynamic, real-time conversations. OpenAI API Key Integration …
    在 GitHub 查看 ↗
  3. v1.2.4
    发布说明摘录
    DemoGPT v1.2.4 🚨 Release Notes Overview We're thrilled to announce the release of DemoGPT v1.2.4! This new version brings a customization property. Editing The Generated Code Now, after you generate the code from your prompt, there is an Edit button under the code. Once you press it, you will be able to change the code and play however you like. Once you are done, press Save & Rerun button, it will rerender the code and open up the new app. Bug Fixes & Improvements …
    在 GitHub 查看 ↗

常见问题

它是否需要 OpenAI 凭据?
README 的 DemoGPT 和 AgentHub 示例使用 OpenAI 模型;未设置 OPENAI_API_KEY 时,需要通过 openai_api_key 参数传入密钥。
RAG 可以处理哪些文件和向量库?
BaseRAG 示例支持添加 PDF、TXT、CSV、JSON 文件,并支持 chroma、pinecone、faiss 作为 vectorstore。
RAG 会改动本地文件吗?
会。示例将向量库写入 persistent_path;当 reset_vectorstore=True 时,示例显示会移除已有的 rag_chroma 向量库。
能否接入自定义业务工具?
可以。继承 BaseTool,设置 name 和 description,并实现 run 方法;随后将工具实例传给 ToolCallingAgent 或 ReactAgent。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。