需完成代码拉取、python虚拟环境搭建、api密钥填入、前后端依赖安装及服务启动五个环节：①克隆ai-app-lab仓库并进入video_analyser目录；②用pyenv安装python 3.11.9并创建激活venv；③在backend/config.py填入vlm_endpoint等5项带双引号的火山方舟凭证；④在frontend/run.sh配置asr_app_id和asr_access_token；⑤cd backend后用poetry install并bash run.sh启动服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在MacBook上配置火山引擎开发环境，需完成代码拉取、Python虚拟环境搭建、API密钥填入、前后端依赖安装及服务启动五个关键环节，缺一不可。
下载并进入项目代码
打开终端，执行以下命令克隆官方AI应用实验室仓库：
git clone https://github.com/volcengine/ai-app-lab.git
进入视频实时理解示例目录：
cd ai-app-lab/demohouse/video_analyser
创建并激活Python虚拟环境
确保已安装Homebrew和pyenv（若未安装，先运行brew install pyenv）。
使用pyenv安装Python 3.11（【必须低于3.12，否则backend部分模块会报错】）：
pyenv install 3.11.9
pyenv local 3.11.9
执行python -V确认版本为3.11.9后，运行：
python -m venv myenv
source myenv/bin/activate
配置后端API参数
修改backend/code/config.py文件，填入从火山方舟控制台获取的5项凭证：
① VLM_ENDPOINT：填写doubao-vision-pro-32k接入点ID（ep-开头字符串）
② LLM_ENDPOINT：填写doubao-pro-32k接入点ID
③ TTS_APP_ID与TTS_ACCESS_TOKEN：语音合成模型凭证，需在TTS服务页开通并复制
④ ARK_API_KEY：火山方舟全局API Key，在「API密钥管理」中生成
注意：所有字段值必须用英文双引号包裹，且不能有多余空格或换行符。
配置前端ASR参数
编辑frontend/run.sh，找到ASR_APP_ID和ASR_ACCESS_TOKEN两行，填入流式语音识别服务的对应凭证。
这两项与TTS凭证不同，必须单独在ASR服务页面开通并获取，【填错会导致前端无法接收语音输入】。
安装依赖并启动服务
进入backend目录：
cd backend
安装Poetry（如未安装）：
curl -sSL https://install.python-poetry.org | python3 -
执行依赖安装：
poetry install
启动后端服务：
bash run.sh
保持该终端窗口开启——服务启动成功后，终端将输出“Uvicorn running on http://0.0.0.0:8000”。
