在 Linux 服务器上安装部署 AIPython 并配置智谱 GLM-4.7-Flash 模型

3 阅读4分钟

在 Linux 服务器上安装部署 AIPython 并配置智谱 GLM-4.7-Flash 模型

一、什么是 AIPython?

AIPython(简称 aipy)是一个功能强大的 AI 辅助编程工具,它可以帮助开发者更高效地编写代码、解决问题,甚至可以通过大语言模型(LLM)生成完整的解决方案。

二、为什么选择智谱 GLM-4.7-Flash?

智谱 GLM-4.7-Flash 是智谱 AI 推出的免费大语言模型,具有以下优势:

  • 性能卓越:在多种基准测试中表现优异
  • 响应速度快:适合实时交互场景
  • 知识覆盖面广:能够处理各种复杂问题
  • 支持多轮对话:可以进行持续的问题解决

三、前置条件

在开始安装前,请确保您的 Linux 服务器满足以下条件:

  • Linux 服务器(Ubuntu 20.04+ 或 CentOS 7+)
  • Python 3.8 或更高版本
  • 网络连接(用于下载和安装软件包)
  • 服务器登录凭证(用户名和密码,或密钥文件)

四、安装步骤

4.1 连接服务器

使用 SSH 连接到您的 Linux 服务器:

Bash
运行
# 使用密码连接
ssh username@server_ip
# 或使用密钥文件连接
ssh -i /path/to/key.pem 
username@server_ip

4.2 创建安装目录

创建 .aipyapp 目录,用于存放 aipy 的配置和数据:

Bash
运行
mkdir -p ~/.aipyapp

4.3 创建虚拟环境

在 .aipyapp 目录中创建虚拟环境,用于隔离 aipy 的依赖:

Bash
运行
python3 -m venv ~/.aipyapp/venv

4.4 升级 pip

升级虚拟环境中的 pip 到最新版本:

Bash
运行
~/.aipyapp/venv/bin/pip install 
--upgrade pip

4.5 安装 aipyapp

在虚拟环境中安装 aipyapp:

Bash
运行
# 直接安装
~/.aipyapp/venv/bin/pip install 
aipyapp
# 或使用镜像源加速安装
~/.aipyapp/venv/bin/pip install 
aipyapp -i https://pypi.tuna.
tsinghua.edu.cn/simple

4.6 创建启动脚本

创建 run_aipy.sh 脚本,方便运行 aipy:

Bash
运行
cat > ~/.aipyapp/run_aipy.sh << EOF
#!/bin/bash
~/.aipyapp/venv/bin/python ~/.
aipyapp/venv/bin/aipy "$@"
EOF
chmod +x ~/.aipyapp/run_aipy.sh

4.7 设置别名(可选)

为了更方便地使用 aipy,可以在 .bashrc 文件中添加别名:

Bash
运行
echo "alias aipy=~/.aipyapp/
run_aipy.sh" >> ~/.bashrc
source ~/.bashrc

五、配置智谱 GLM-4.7-Flash 模型

5.1 获取智谱 API 密钥

  1. 访问 智谱 AI 开放平台
  2. 注册或登录账号
  3. 创建应用并获取 API 密钥

5.2 配置 user_config.toml 文件

创建并编辑 user_config.toml 文件,配置智谱 GLM-4.7-Flash 模型:

Bash
运行
cat > ~/.aipyapp/user_config.toml 
<< EOF
[llm.zhipu]
base_url = "https://open.bigmodel.
cn/api/paas/v4"
api_key = "your_api_key_here"
model = "glm-4.7-flash"
type = "bigmodel"
enable = true
default = true
EOF

注意:请将 your_api_key_here 替换为您的智谱 AI API 密钥。

六、测试安装和配置

6.1 测试 aipy 版本

运行以下命令,测试 aipy 是否安装成功:

Bash
运行
~/.aipyapp/run_aipy.sh --version

如果安装成功,您将看到 aipy 的版本信息。

6.2 测试模型连接

运行以下命令,测试 aipy 是否能够成功连接到智谱 GLM-4.7-Flash 模型:

Bash
运行
~/.aipyapp/run_aipy.sh run "你好,请
问1+1等于多少?"

如果配置成功,您将看到模型的响应。

七、常见问题与解决方案

7.1 安装失败

问题:使用默认源安装失败。 解决方案:使用镜像源加速安装:

Bash
运行
~/.aipyapp/venv/bin/pip install 
aipyapp -i https://pypi.tuna.
tsinghua.edu.cn/simple

7.2 虚拟环境创建失败

问题:创建虚拟环境时出现错误。 解决方案:确保 Python 版本符合要求(3.8+),并安装 venv 模块:

Bash
运行
# Ubuntu/Debian
sudo apt install python3-venv
# CentOS/RHEL
sudo yum install python3-venv

7.3 模型连接失败

问题:连接智谱 GLM-4.7-Flash 模型时出现认证错误。 解决方案

  • 检查 API 密钥是否正确
  • 确保 API 密钥格式正确(智谱 AI 使用 APIKey.APIKeySecret 格式)
  • 检查网络连接是否正常

7.4 启动脚本无法执行

问题:运行 run_aipy.sh 时出现权限错误。 解决方案:确保脚本具有执行权限:

Bash
运行
chmod +x ~/.aipyapp/run_aipy.sh

八、总结

通过以上步骤,您已经成功在 Linux 服务器上安装部署了 AIPython,并配置了智谱 GLM-4.7-Flash 模型。现在,您可以使用 aipy 来帮助您更高效地编写代码、解决问题,甚至可以通过大语言模型生成完整的解决方案。

使用方法:

  • 执行简单任务:aipy run "你的问题"
  • 启动交互式会话:aipy agent
  • 查看帮助信息:aipy --help

希望本教程对您有所帮助!如果您在安装过程中遇到任何问题,请参考常见问题与解决方案部分,或查阅 aipy 的官方文档。