欢迎 👋

这是一个基于生成式 UI 的金融代理。

我们使用 Vercel 的 AI SDK 和 LangChain 的 代理 来动态回答问题并渲染 UI。

此外，我们还使用金融数据集中的股票市场 API 获取实时股票数据和深度财务信息。

最后，对于通用的网络搜索，我们使用 Tavily 的 搜索 API。

开始使用 🚀

1. 将仓库克隆到本地：

   git clone https://github.com/virattt/financial-agent-ui.git
   

2. 在项目根目录下（与 .env.example 文件相邻）创建一个 .env 文件，并添加以下内容：

   OPENAI_API_KEY=               # 从 https://platform.openai.com 获取
   FINANCIAL_DATASETS_API_KEY=   # 从 https://financialdatasets.ai 获取
   TAVILY_API_KEY=               # 从 https://tavily.com 获取
   

运行代理

我们强烈建议使用 Docker 来运行应用程序。这样可以确保所有依赖项都已安装，并且应用程序能够顺利运行。

您可以在 这里 找到 Docker 的安装说明。

安装完成后，在项目根目录下运行以下命令以启动应用程序：

 docker-compose up

如果您不想使用 Docker，也可以手动安装应用程序。

• 要运行 backend 服务器，请参阅 这里 的说明。
• 要运行 frontend 应用程序，请参阅 这里 的说明。

免责声明 🛑

本应用的目标仅用于探索生成式 AI 和 UI。

此金融代理并非旨在提供财务建议。它旨在为用户提供工具和信息，以便仅就生成式 AI 相关的技术概念进行探索。用户在做出任何财务决策之前，应自行进行研究或咨询财务顾问。

参与贡献 👷‍♂️

欢迎贡献！如果您发现任何问题或有改进建议，请提交一个问题或拉取请求。

许可证 📜

本项目采用 MIT 许可证 许可。

贡献者 ❤️

financial-agent-ui 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、macOS 或 Windows（推荐配合 WSL2 使用）
• 核心依赖：
  • Docker 及 Docker Compose（强烈推荐用于一键部署）
  • 或者手动安装：Node.js (前端) 和 Python (后端)
• API 密钥：您需要提前申请以下三个服务的 API Key：
  • OpenAI API Key：用于大模型推理
  • Financial Datasets API Key：用于获取实时股票数据
  • Tavily API Key：用于通用网络搜索

注意：由于部分服务（如 OpenAI、Tavily）在中国大陆地区可能无法直接访问，请确保您的网络环境已配置好代理，或在 Docker/系统层面设置了正确的 HTTP_PROXY / HTTPS_PROXY。

安装步骤

1. 克隆项目

将代码仓库下载到本地：

git clone https://github.com/virattt/financial-agent-ui.git
cd financial-agent-ui

2. 配置环境变量

在项目根目录下创建 .env 文件（可参考 .env.example），并填入您申请的 API 密钥：

cp .env.example .env

编辑 .env 文件，内容如下：

OPENAI_API_KEY=sk-your-openai-key-here
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-key
TAVILY_API_KEY=your-tavily-key

3. 启动应用

推荐方式：使用 Docker 这是最简便的方法，可自动处理所有前后端依赖。在项目根目录执行：

docker-compose up

备选方式：手动运行 如果您不希望使用 Docker，需分别启动后端和前端（具体细节请参考项目子目录说明）：

• 后端服务：查看 backend/README.md
• 前端应用：查看 frontend/README.md

基本使用

1. 访问界面： 启动成功后，打开浏览器访问 http://localhost:3000（默认端口，如有变动请查看终端输出）。

2. 发起查询： 在对话框中输入自然语言指令，例如：

   • "Show me the latest stock price for Apple."（显示苹果公司的最新股价）
   • "What are the recent financial trends for Tesla?"（特斯拉最近的财务趋势如何？）
   • "Search for news about the current inflation rate."（搜索关于当前通胀率的新闻）

3. 查看结果： 系统将调用 AI Agent 动态生成回答，并结合实时金融数据渲染出图表或结构化 UI 组件。

---

免责声明：本工具仅用于探索生成式 AI 与 UI 技术，不构成任何投资建议。请在做出任何金融决策前自行研究或咨询专业顾问。