Ubuntu中为AI Agent相关开发配置Python环境

前言

由于AI发展速度过快而且变态，上周末和领导聊了聊未来的规划，接下来团队要切入 AI Agent 相关开发，学习、使用、开发都需要配置 Python 环境，这里记录下 Ubuntu 22.04.5 LTS 如何配置 Python 环境

我的 Ubuntu 是 win11 WSL中安装的，Ubuntu 服务器默认会预装 Python，我查的我这里的版本是 3.10.12

直接用 python3 -V 命令查看版本

因为后面可能会出现不同项目不同版本，因此不推荐使用系统自带的 Python，修改系统Python也可能会导致系统命令异常

下面是 pyenv + virtualenv 的方式配置 Python 环境

pyenv

pyenv是一个跨平台的 Python 版本管理工具（支持 Linux、macOS，Windows 可通过 WSL 使用），它的核心作用是：在系统中安装、管理多个不同版本的 Python，并能为不同项目指定专属的 Python 版本，而不会干扰系统全局的 Python 环境

安装 pyenv 依赖

bash 复制代码

sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev \
git python3-pip

安装 pyenv

这是官方的自动安装脚本，简单高效

bash 复制代码

curl https://pyenv.run | bash

配置环境变量

将 pyenv 的路径添加到~/.bashrc，注意！ ，如果是 zsh，则是~/.zshrc

bash 复制代码

# 向~/.bashrc中添加环境变量
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

# 使配置立即生效
source ~/.bashrc

安装 Python

AI Agent 开发推荐版本为 3.10 ，据说兼容性相对是最好的

查询可安装的 Python 3.10 版本

bash 复制代码

pyenv install --list | grep "3.10"

例如选择 3.10.19 版本

安装具体Python 版本

bash 复制代码

pyenv global 3.10.19

验证

bash 复制代码

python3 -V

如果显示 Python 3.10.19，则表示 Python 安装成功

创建AI Agent项目虚拟环境

设置项目对应的 Python 版本

注意！ 这里的设置是项目级别的，不影响系统级别(全局)的 Python

bash 复制代码

# 创建项目目录并进入
mkdir -p ~/AIProjects/ai-agent-project && cd ~/AIProjects/ai-agent-project
# 设置当前目录使用Python 3.10.19
pyenv local 3.10.19

这是项目地址下的版本

这是全局的版本，全局的版本和项目版本是隔离的

安装 virtualenv 虚拟环境管理工具

virtualenv是一个Python 虚拟环境管理工具，核心作用是：为每个 Python 项目创建一个独立的、隔离的运行环境。每个环境都有自己的 Python 解释器和独立的site-packages目录，用于存放该项目所需的依赖包，不同项目的依赖包互不干扰

bash 复制代码

# 安装virtualenv
pip install virtualenv
# 创建名为venv的虚拟环境（名字可自定义）
virtualenv venv
# 激活虚拟环境
source venv/bin/activate

激活后，终端前缀会显示(venv)，表示已进入专属环境，如下效果

安装 AI Agent 核心依赖

bash 复制代码

# 核心AI Agent框架
pip install langchain langchain-openai langchain-community
# 文档处理、向量数据库
pip install pypdf chromadb faiss-cpu
# 深度学习/本地模型依赖
pip install torch transformers
# 其他工具库
pip install python-dotenv requests

python-dotenv：管理环境变量的工具，主要功能是从.env文件中读取环境变量并加载到 Python 的os.environ中

requests：用于发送 HTTP 请求的库，主要功能是发送 HTTP 请求并返回响应

退出虚拟环境

bash 复制代码

deactivate

删除虚拟环境

bash 复制代码

# 删除虚拟环境
cd ~/AIProjects/ai-agent-project
rm -rf venv

删除虚拟环境后，项目目录下的 venv 文件夹将不存在

小结

AI Agent 开发环境配置完成了，在Linux中操作环境真是一如既往的丝滑，接下来将逐步学习简单Agent相关的开发内容，如果 Agent 涉及大量数据科学库，需要使用 Miniconda（环境 + 包管理） 的相关方案了

欢迎交流