ten-framework

环境要求

• 已安装 Docker 并能执行 docker 命令
• 已安装 git（用于获取项目代码）
• 准备好示例智能体的 .env 环境变量文件（含所需模型/服务密钥）
• Docker 命令需在容器外部执行

安装与启动步骤

1. 1获取项目代码

   克隆 TEN Framework 仓库到本地，后续 Docker 构建在仓库的 ai_agents 目录下进行。

   git clone https://github.com/TEN-framework/ten-framework.git
   cd ten-framework

   复制

2. 2进入 ai_agents 目录

   Docker 构建和运行命令都要求在 ai_agents 目录下执行。

   cd ai_agents

   复制

3. 3构建示例镜像

   把 <example-name> 换成实际示例名，使用对应 Dockerfile 构建名为 example-app 的镜像。

   docker build -f agents/examples/<example-name>/Dockerfile -t example-app .

   复制

4. 4准备环境变量文件

   在 ai_agents 目录下准备 .env 文件，填入示例所需的密钥等环境变量，运行时会通过 --env-file 读取。

5. 5启动容器

   映射 3000 端口并加载 .env 运行镜像，--rm 表示退出后自动删除容器。

   docker run --rm -it --env-file .env -p 3000:3000 example-app

   复制

关键配置

如何确认成功

docker run 后无报错退出，浏览器访问 http://localhost:3000 能看到智能体页面。

常见问题

注意事项

• 所有 Docker 命令必须在任何 Docker 容器外部执行。
• 部署到 Vercel/Netlify 时需确保后端接受前端来源的请求（开放 CORS 或使用内置代理中间件）。
• 仓库为多示例结构，构建前请把 <example-name> 替换成实际示例名。