virattt/dexter

项目介绍

Dexter 是一个用 TypeScript 编写的金融研究智能体。面对复杂的金融问题，它会先把问题拆成结构化的研究步骤，再选择工具获取财务数据，并对自己的结果进行检查和迭代，最后给出带数据支撑的答案。README 列出的能力包括任务规划、自主调用工具、自我验证，以及获取利润表、资产负债表和现金流量表等实时财务数据；同时内置循环检测和步数限制，避免执行失控 项目概览。

项目明确把自己定位为教育、娱乐和信息参考用途，而非真实交易或投资工具。README 声明输出可能不准确、不完整或过时，不构成投资建议 免责声明。如果打算把它的结论用于实际决策，这一点需要认真对待。

快速使用

运行前需要 Bun（v1.0 或更高）、OpenAI API key 和 Financial Datasets API key；Exa API key 是可选项，用于联网搜索 前置条件。安装 Bun 后，克隆仓库并安装依赖：

git clone https://github.com/virattt/dexter.git
cd dexter
bun install
cp env.example .env

编辑 .env，至少填入 OPENAI_API_KEY 和 FINANCIAL_DATASETS_API_KEY；如果使用 Anthropic、Google、xAI、OpenRouter、Exa 或 Tavily，可再补充对应 key 环境变量配置。然后以交互模式启动：

bun start

开发时可用 bun dev 以 watch 模式运行 运行方式。

评测与调试

仓库自带评测套件，用一批金融问题测试智能体，通过 LangSmith 记录结果，并用 LLM-as-judge 判断答案正确性。可以跑全部问题，也可以随机抽样：

bun run src/evals/run.ts
bun run src/evals/run.ts --sample 10

每次查询还会在 .dexter/scratchpad/ 下生成 JSONL 草稿文件，记录原始问题、每次工具调用的参数与结果，以及推理步骤，便于查清答案是怎么来的 评测 调试。

其他入口

Dexter 可以通过本地网关接入 WhatsApp：运行 bun run gateway:login 扫码登录，再运行 bun run gateway，之后在 WhatsApp 里给自己发消息即可提问 WhatsApp 网关。这需要绑定自己的 WhatsApp 账号并在本地运行网关。

使用约束

• 必须安装 Bun，安装和启动命令都基于 bun install 与 bun start。
• 财务数据依赖 Financial Datasets API key，智能体本身依赖 LLM 服务商的 key；联网搜索还需要 Exa 或 Tavily 的 key。
• 项目声明仅供教育、娱乐和信息参考，不对准确性或投资适用性作保证。
• README 写明采用 MIT 许可证 许可证，但仓库元数据未声明许可证。

HotRepo 点评

在 2026-11-09 的 TypeScript 日榜中，Dexter 记录到 27,802 个 Star、当日新增 21 个 Star，位列该语言榜第 11 名。这只是单日快照，只能说明当天仍有新增关注，不能据此判断长期趋势。项目值得看的地方在于它把研究流程显式做出来：规划、调用工具、自我检查，并用 scratchpad 留下可追溯的记录，读者能检查过程而不只是看答案。按作者自己的定位，它的输出更适合当作研究辅助。