Vibe-Research

连接你的AI密钥，自动生成每日复盘和个股雷达，让投研更高效。

Vibe-Research 是一款面向个人投资者的开源 AI 投研助手，专注于 A股、美股和港股市场。它解决了个人投资者信息分散、复盘耗时、研究效率低下的问题，通过每日复盘、资讯雷达、个股数据、板块中心、持仓管理和研究记录等模块，将市场数据、新闻资讯与 AI 分析能力整合到一个仪表盘中。项目采用 React 前端和 FastAPI 后端，支持 MCP（模型上下文协议），允许用户接入自己的 LLM API 密钥，实现个性化 AI 驱动的投资研究。其核心能力包括自动生成每日市场复盘报告、实时监控个股和板块动态、提供结构化数据展示，并支持用户记录和追踪研究思路，帮助投资者更系统、高效地做出决策。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2555

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队simonlin1212

所属国家

官网地址https://viberesearch.wiki

GitHubhttps://github.com/simonlin1212/Vibe-Research

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型a-stock,ai-agent,codex,codex-harness,dashboard,financial-research,fintech,hk-stocks,investment-research,llm,local-agent,mcp,python,react,stock-market,trading,us-stocks

GitHub 星标★ 2555

30天Star增速

HF 下载量

上线时间2026-07-05 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 15 分钟部署方式：本地安装 7 步

环境要求

已安装 Node.js（命令行可用）
已安装 Python（脚本会创建 .venv 虚拟环境）
已安装 Git（用于克隆仓库）
macOS、Windows、Linux 均可，流程一致

安装与启动步骤

1准备运行环境

首次使用需先在本机安装 Node.js、Python 和 Git，三者都要能在终端里直接调用。
2克隆代码仓库

把仓库克隆到本地并进入项目目录，Windows 与 macOS/Linux 命令完全相同。
```
git clone https://github.com/simonlin1212/Vibe-Research.git vibe-research-agent
cd vibe-research-agent
```
3初始化依赖

macOS/Linux 执行 scripts/setup，自动创建 .venv、装 Agent 引擎与前后端依赖、初始化私有目录并体检。
```
scripts/setup
```
4Windows初始化

Windows 改用 scriptssetup-windows.cmd，作用与 scripts/setup 一致，同样会安装依赖并运行体检。
```
scriptssetup-windows.cmd
```
5启动本地服务

同时启动本机 API 与浏览器 UI；Windows 用 scriptsstart.cmd，加 --no-open 可不自动开浏览器，Ctrl+C 同时关闭两端。
```
scripts/start
```
6打开浏览器界面

在浏览器访问该地址即可看到工作台；Vite 只在本机代理 /api/*，并在服务端补上鉴权信息。
7命令行跑研究

用命令行跑一次完整六阶段研究，结果写入 .local/runs//，Windows 用 PowerShell 版本并指定 .venv 里的 python。
```
node orchestrator/src/run.ts 
  --symbol 300308 
  --market SZ 
  --python "$(pwd)/.venv/bin/python" < /dev/null
```

关键配置

配置项	必填	说明	示例
`VRA_DATA_ROOT`	否	自定义数据根目录，API 与前端两个进程必须使用同一个值	`/your/path`

如何确认成功

浏览器打开 http://127.0.0.1:5930 能正常显示工作台界面，即表示启动成功。

常见问题

Q：需要全局安装 Codex 吗？

A：不需要。scripts/setup 会安装本产品自带的 Agent 引擎，也无需打开两个终端。

Q：如何启动时不自动打开浏览器？

A：macOS / Linux 下运行 scripts/start --no-open 即可；按 Ctrl+C 会同时关闭 API 与界面两端。

Q：旧 Mac 客户端的数据会自动迁移吗？

A：不会自动迁入源码工作区。不要删除 ~/.vibe-research-desktop，也不要把它提交到仓库。

Q：命令行研究要跑多久？

A：取决于取数范围、模型响应与校验重试，可能需要数十分钟或更久，不承诺固定时长。

Q：运行退出码代表什么？

A：0 为 complete（完成），2 为 incomplete/stale（未完成或过期），3 为 failed（失败）。

注意事项

已有源码副本时先备份自己的数据，再更新代码并执行 setup，不必重新克隆。
页面完全在本机运行，不是把私人研究上传到网站。
命令行研究产出 report.md、evidence.json、calculations.json、conflicts.json、manifest.json、viewer.html。
desktop/ 是浏览器前端目录，并非 Mac 客户端。

核心亮点

覆盖A股、美股、港股三大市场，数据维度全面，适合多市场投资者
支持MCP协议和自定义LLM API，灵活接入个人AI模型，保护隐私
内置每日复盘和资讯雷达，自动化生成投研报告，节省人工整理时间

不足之处

依赖用户自备LLM API密钥，对非技术用户有一定使用门槛
文档/社区待观察

适用场景

个人投资者每日快速获取市场复盘和持仓异动提醒
研究特定股票时，集中查看财务、新闻和板块关联数据
记录并追踪自己的投资假设和研究笔记，形成个人投研知识库

替代项目

OpenBB、FinGPT、StockSharp

项目介绍

Vibe-Research 是智能体领域的开源项目，由 simonlin1212 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,555）位列前 30%，在智能体分类的 2,499 个项目里位列前 15%。

近 45 天，它的 GitHub 星标从 1,929 增加到 2,555，净增 626。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人投资者每日快速获取市场复盘和持仓异动提醒。同类可对比的替代方案包括 OpenBB、FinGPT、StockSharp。

上一篇：awesome_ai_agents

下一篇：cindy