ax

用 TypeScript 写 DSPy，让 LLM 应用开发更工程化

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 201 🐛 待处理 4 👀 关注 20

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2979

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源框架，Apache-2.0 许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类搜索知识

开发团队ax-llm

官网地址http://axllm.dev

GitHubhttps://github.com/ax-llm/ax

定价模式🏷️完全免费

价格说明开源框架，Apache-2.0 许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agents,ai,anthropic,claude,cohere,dspy,gemini,google,google-gemini,grok,javascript,large-language-models,llm,nodejs,ollama,openai,opensource,rlm,typescript

GitHub 星标★ 2979

上线时间2023-02-23 00:00:00

代码更新2026-11-06

仓库体积109.8 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数7

项目介绍

ax 是 TypeScript 生态中一个备受关注的 DSPy 框架实现，旨在将 DSPy 的声明式编程范式引入 TypeScript 世界。它解决的是在构建复杂语言模型应用时，如何以模块化、可组合的方式管理提示、模型调用和优化流程的问题。核心能力包括：提供类似 DSPy 的签名（Signature）和模块（Module）抽象，支持定义输入输出规范并自动生成提示；内置优化器，可自动调整提示或模型参数以提升任务表现；与主流 LLM 提供商（如 OpenAI、Anthropic）无缝集成，并提供类型安全的开发体验。ax 让 TypeScript 开发者能够以更工程化、可维护的方式构建可靠的 LLM 应用，减少手动提示工程的繁琐和脆弱性。

Star 增长趋势

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

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

技术标签

agents ai anthropic claude cohere

使用教程

难度：入门约 10 分钟部署方式：库/依赖 6 步

环境要求

Node.js 运行环境（README 提到 Node 20+ 会自动启用 OS Permission Model）
npm 包管理器（README 中的安装与示例命令均基于 npm）
一个 LLM 提供商的 API Key（示例从环境变量或 .env 读取，如 OPENAI_APIKEY）
Go 1.23+（仅在使用 Go 实时音频包时需要）

安装与启动步骤

1安装核心包

在 TypeScript/JavaScript 项目中安装 Ax 主包 @ax-llm/ax，Ax 是 TypeScript 优先的。
```
npm install @ax-llm/ax
```
2按需安装扩展包

Bedrock provider、Vercel AI SDK v7 集成、MCP stdio 与 JS 运行时扩展都是可选包，用到再装。
```
npm install @ax-llm/ax-ai-aws-bedrock
npm install @ax-llm/ax-ai-sdk-provider
npm install @ax-llm/ax-tools
```
3其他语言包(可选)

若使用编译生成的 Python/Rust/Go 库，用各自包管理器安装；Java 用 Maven Central 的 dev.axllm:ax，C++ 用 CMake FetchContent。
```
pip install axllm
cargo add axllm
go get github.com/ax-llm/ax/packages/go
```
4克隆示例仓库

公开示例和运行脚本都在仓库内，需克隆后才能执行 npm run example 系列命令。
```
git clone https://github.com/ax-llm/ax.git
cd ax
```
5查看示例列表

列出 TS、Python、Java、C++、Go、Rust 的公开示例，加 --json 可输出结构化结果。
```
npm run example -- list
```
6配置密钥并运行示例

示例会调用真实提供商，密钥从环境变量或 .env 读取；这里以 OpenAI 生成示例为例。
```
OPENAI_APIKEY=your-key npm run example -- ts src/examples/typescript/generation/axgen-openai.ts
```

关键配置

配置项	必填	说明	示例
`OPENAI_APIKEY`	是	运行 OpenAI 相关示例时使用的 API 密钥	`your-key`

如何确认成功

执行 npm run example -- list 能列出各语言示例，或带 OPENAI_APIKEY 运行任一示例后看到模型返回结果。

常见问题

Q：ax 只支持 TypeScript 吗？

A：不是。Ax 以 TypeScript 优先，但同一套签名、provider 映射、agents、flows 和优化器也会编译成 Python、Java、C++、Go、Rust 库。

Q：运行示例需要什么凭证？

A：示例调用真实提供商，会从 .env 或环境变量读取凭证，例如 OPENAI_APIKEY。请先配置好对应提供商的密钥。

Q：AxJSRuntime 是安全沙箱吗？

A：它是针对 LLM 生成代码的纵深防御，不是容器或 VM 边界。宿主回调和授予的权限仍是信任边界，密钥应留在宿主侧。

Q：如何切换不同的模型提供商？

A：通过命名部署配置（deployment profiles）选择，部署名决定线路行为，模型 ID 只在该部署内部解析。

注意事项

实时音频需额外依赖：Python 用 pip install axllm[realtime]，Rust 加 --features realtime，C++ 用 -DAXLLM_ENABLE_REALTIME=ON。
memories 的生命周期只有一次 .forward()，要跨调用保留必须自行外部持久化。
默认沙箱已冻结 intrinsics、锁定 ShadowRealm 与 worker IPC，并阻止 import()，只在需要时授予 NETWORK、FILESYSTEM 等权限。
所有生成的 Python、Java、C++、Go、Rust 库均为 Apache-2.0 许可。