准备工作

1. 一台能联网的电脑。
2. 安装好git，git-lfs
3. 有ModelScopehttps://www.modelscope.cn/的账号
4. 有阿里云账号，并开通了DashScope(灵积)的相关权限，灵积官网：https://dashscope.aliyun.com/

本地开发

1. 进入ModelScope的创空间，选择我要创建，填好项目名称后，点击最下面的创建创空间即可，其他都默认就行。
   
2. 根据提示，克隆你的仓库到本机。
   
3. 克隆modelscope-agent仓库到你本机

git clone https://github.com/modelscope/modelscope-agent.git

4. 用anaconda创建一个虚拟python3.10的环境（可选，建议），然后进入modelscope-agent目录，安装对应Python依赖。

cd modelscope-agent
pip install -r requirements.txt

5. 然后，将modelscope-agent下面所有文件拷贝到你从创空间那里克隆的项目中。
6. 重命名requirements.txt为requirements-dev.txt，防止被覆盖。
7. 将apps\agentfabric下面所有文件放到你的项目根目录。Linux用户可以参考下面这个命令：

cp -r apps\agentfabric\* .

8. 再次安装该app需要的依赖。

pip install -r requirements.txt

9. 设置环境变量，Linux/Mac可以通过~/.bashrc中设置（也可以用export临时导入），Windows可以在设置-系统信息-高级环境设置-环境变量-用户变量新建环境变量即可。

• 在MODELSCOPE_API_TOKEN中填上你的ModelScore SDK令牌，快速获取地址https://www.modelscope.cn/my/myaccesstoken
• 在DASHSCOPE_API_KEY中填上你的灵积api，快速获取地址https://dashscope.console.aliyun.com/apiKey
  
• windows用户记得重启一下开发工具，否则环境变量不会立即生效。

10. 最后，运行appBot.py，浏览器打开http://127.0.0.1:7860/，开始聊天吧，如果正常说明是ok的。

• 第一次运行可以会爆错，提示缺少appdirs，用pip安装一下就可以了，安装命令，可以顺便把appdirs这个依赖加到requirements.txt中

pip install appdirs

• 注：默认的app.py是用于零代码创建应用的那个界面，那个不太方便代码开发，所以我们这里要用appBot.py的内容做开发。

11. 经过上线测试发现app.py是默认启动文件，所以这里我们将appBot.py和app.py名称换换，方便上线后系统会自动运行app.py。

mv appBot.py appTemp.py
mv app.py appBot.py
mv appTemp.py app.py

12. 测试无误后，用git将代码上传到modelscope即可。

项目发布

1. 回到最早你创建的创空间，可以访问该链接https://www.modelscope.cn/my/myspace，选择我的创空间，找到刚刚的项目。
2. 点击设置界面，选择环境变量管理，新增两个变量，就是刚刚的MODELSCOPE_API_TOKEN和DASHSCOPE_API_KEY和其对应的数值。
3. 然后选择上线空间展示即可正式上线项目，若未开发完毕，可以选择设为非公开空间。
   
4. 最后，等待5-10分钟，选择返回创空间，既可看到上线后的效果了，和刚刚本机运行app.py是一样的。
   

体验地址

• 随手做了一个订票模拟器，体验地址：https://www.modelscope.cn/studios/Tlntin/booking_simulator/summary
• 觉得有用的，可以在体验地址，右上角帮忙点一个小心心哦。