5分钟上手 Dexter 金融研究智能体

本指南将帮助你在5分钟内完成Dexter的安装配置,并运行一个金融分析示例

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Bun >= 1.0 必需

所需工具

Git

克隆项目代码

必需

操作步骤

1

安装Bun运行环境

Dexter使用Bun作为运行时,首先需要安装Bun

macOS/Linux安装命令
curl -fsSL https://bun.sh/install | bash
Windows安装命令
powershell -c "irm bun.sh/install.ps1 | iex"

预期结果:安装完成后,重启终端并运行 bun --version 应显示版本号

如果遇到权限问题,可能需要使用sudo(Linux/macOS)或以管理员身份运行(Windows)

2

克隆项目并安装依赖

获取Dexter源代码并安装必要的依赖包

克隆项目到本地
git clone https://github.com/virattt/dexter.git
进入项目目录并安装依赖
cd dexter && bun install

预期结果:依赖安装成功,没有错误信息

确保网络连接正常,依赖包下载可能需要几分钟

3

配置API密钥

创建环境变量文件并填入必要的API密钥

复制环境变量模板
cp .env.example .env

预期结果:.env文件创建成功

需要准备以下API密钥:OpenAI API key(必需)、Financial Datasets API key(必需)、Exa API key(可选,用于网络搜索)

4

运行Dexter交互模式

启动Dexter并尝试一个简单的金融分析问题

启动交互式命令行界面
bun run start

预期结果:看到Dexter的欢迎界面和提示符,可以输入金融分析问题

首次运行时,Dexter会开始分析你输入的问题,如"分析苹果公司2023年的财务状况"

验证成功

成功运行Dexter后,你将看到以下迹象

看到Dexter的欢迎界面和交互提示符
可以输入金融分析问题并获得响应
在.dexter/scratchpad/目录下生成分析日志文件

快速提示

配置

如果遇到API密钥错误,请检查.env文件中的密钥格式是否正确

调试

使用 bun run start:watch 可以在开发模式下运行,代码更改后自动重启

调试

所有分析过程都会记录在.dexter/scratchpad/目录中,便于调试

常见问题

1

bun: command not found

Bun未正确安装或PATH环境变量未配置,请重新安装Bun并重启终端

2

OpenAI API key is missing

检查.env文件中OPENAI_API_KEY是否已正确设置,确保没有多余的空格或引号

3

依赖安装失败

尝试清理缓存后重新安装:bun clean && bun install

下一步

查看分析日志

检查.dexter/scratchpad/目录下的JSONL文件,了解Dexter的分析过程

运行评估套件

使用 bun run eval 测试Dexter在标准问题集上的表现

修改.env配置

添加Exa API密钥以启用网络搜索功能,增强数据获取能力

助手