Vibe-Research

Q: 需要全局安装 Codex 吗？

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

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

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

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

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

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

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

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

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

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

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 670 🐛 待处理 4 👀 关注 18

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3525

维护状态较活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队simonlin1212

官网地址https://viberesearch.wiki

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

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 3525

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

代码更新2026-10-29

仓库体积24.6 MB

本站数据更新2026-11-08

维护状态较活跃

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3525

技术标签

ai-agent claude-code codex dashboard fintech

使用教程

难度：入门约 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 改用 scripts\setup-windows.cmd，作用与 scripts/setup 一致，同样会安装依赖并运行体检。
```
scripts\setup-windows.cmd
```
5启动本地服务

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

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

用命令行跑一次完整六阶段研究，结果写入 .local/runs/<run-id>/，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 客户端。