TEN-framework开发环境搭建：从零开始的完整配置指南

TEN-framework开发环境搭建：从零开始的完整配置指南

【免费下载链接】ten-framework Open-source framework for conversational voice AI agents 项目地址: https://gitcode.com/TEN-framework/ten-framework

🚀 终极目标：在15分钟内完成TEN-framework开发环境的完整搭建，并运行你的第一个语音AI应用！

TEN-framework是一个开源的对话式语音AI智能体框架，支持多语言扩展开发，让你能够快速构建智能语音助手、实时转录系统和语音对话应用。本文将带你完成从环境准备到第一个应用运行的完整流程。

📋 前置条件检查

在开始搭建TEN-framework开发环境之前，请确保你的系统满足以下要求：

系统要求

• 操作系统：Linux (x64)、macOS Intel (x64)、macOS Apple Silicon (arm64)
• 内存：至少4GB RAM
• CPU：至少2核心

软件要求

• Python 3.10+ - 核心运行时环境
• Go 1.20+ - 高性能扩展开发
• Node.js LTS - 前端界面和JavaScript扩展

🛠️ 第一步：安装TEN Manager (tman)

TEN Manager (tman) 是TEN-framework的命令行管理工具，负责项目管理、依赖安装和应用运行。

一键安装命令：

curl -fsSL https://raw.githubusercontent.com/TEN-framework/ten-framework/main/tools/tman/install_tman.sh | bash

验证安装：

tman --version
# 应该显示类似：tman version 0.11.0

🎯 第二步：创建第一个TEN应用

1. 创建应用项目

tman create app transcriber_demo --template transcriber_demo
cd transcriber_demo

2. 安装项目依赖

# 安装TEN包依赖
tman install

# 安装Python和npm包依赖
tman run install_deps

3. 构建应用

tman run build

🔧 第三步：配置环境变量

在运行应用前，需要配置语音识别服务的凭据。创建.env文件：

# Azure语音服务配置
AZURE_STT_KEY=your_azure_speech_api_key
AZURE_STT_REGION=your_azure_region
AZURE_STT_LANGUAGE=en-US

🚀 第四步：运行和体验应用

启动应用

tman run start

成功启动后，你将看到类似输出：

[web_audio_control_go] Web服务器已启动在端口8080
[audio_file_player_python] AudioFilePlayerExtension已启动

访问应用界面

打开浏览器访问：http://localhost:8080

你将看到转录演示的Web界面，可以：

• 🎤 点击麦克风按钮进行实时语音转录
• 📁 上传音频文件进行转录
• 📝 查看实时转录和字幕结果

TEN-framework应用界面

📁 项目结构解析

了解TEN-framework的项目结构有助于更好地进行开发：

ten-framework/
├── core/           # 核心框架代码
├── ai_agents/      # AI智能体示例
├── packages/       # 核心包和扩展
├── third_party/    # 第三方依赖库
└── tools/         # 开发工具和脚本

🔄 Docker开发环境（可选）

对于更复杂的开发场景，可以使用Docker环境：

1. 进入AI智能体目录

cd ai_agents

2. 复制环境配置文件

cp ./.env.example ./.env

3. 启动开发容器

docker compose up -d

4. 进入容器

docker exec -it ten_agent_dev bash

🛠️ 开发工具和实用命令

代码格式化

task format

代码检查

task lint

运行测试

task test

🚨 常见问题解决

问题1：Python库加载失败（macOS）

解决方案：

export DYLD_LIBRARY_PATH=/usr/local/opt/python@3.10/Frameworks/Python.framework/Versions/3.10/lib:$DYLD_LIBRARY_PATH

问题2：端口8080被占用

解决方案：

lsof -i :8080    # 查找占用端口的进程
kill -9 <PID>       # 结束进程

问题3：Go构建失败

解决方案：

go clean -modcache  # 清理Go模块缓存
tman run build      # 重新构建

🎉 恭喜！开发环境搭建完成

你现在已经成功搭建了TEN-framework开发环境！🎊

下一步可以：

1. 探索云端商店，下载更多扩展
2. 使用TMAN Designer设计你的应用流程
3. 开发自定义扩展 - 支持Go、Python、TypeScript等多种语言

开发成功庆祝

TEN-framework的强大之处在于其多语言扩展能力，让你能够根据具体需求选择最适合的开发语言来构建高性能的语音AI应用。

💡 专业提示：建议使用Python虚拟环境来管理依赖，避免与系统Python版本冲突。

【免费下载链接】ten-framework Open-source framework for conversational voice AI agents 项目地址: https://gitcode.com/TEN-framework/ten-framework