大模型应用开发 / 系统课时

创建项目环境

创建项目环境

本课会从零建立一个可重复、可隔离的 Python RAG 项目环境:创建虚拟环境、安装最小依赖,并把配置、数据、索引、服务与测试目录一次规划清楚,最终得到可以继续开发和验证的项目骨架。

学习目标

  • 创建并激活项目专用虚拟环境
  • 安装生成模型、配置、向量库与测试依赖
  • 建立职责清晰且便于扩展的目录结构

检查运行环境

先确认本机能够调用 Python 和 pip。建议使用 Python 3.10 或更高版本,并始终通过 python -m pip 调用当前解释器对应的包管理器。

bash
python --version
python -m pip --version

预期输出

text
Python 3.<MINOR>.<PATCH>
pip <VERSION> from <PATH>

<MINOR>、<PATCH>、<VERSION> 和 <PATH> 会因本机环境不同而变化。若两条命令指向不同 Python 安装,应先修正 PATH 或改用明确的解释器路径。

创建隔离环境

在空目录中创建项目,再生成名为 .venv 的虚拟环境。Linux 和 macOS 使用下面的命令;Windows PowerShell 的激活命令是 .\.venv\Scripts\Activate.ps1。

bash
mkdir rag-demo
cd rag-demo
python -m venv .venv
source .venv/bin/activate
python -c "import sys; print(sys.prefix)"

预期输出

text
<PATH>/rag-demo/.venv

终端提示符通常会出现 (.venv)。退出环境时执行 deactivate,不要删除全局 Python,也不要把依赖直接安装到系统解释器中。

安装核心依赖

本项目先安装四类最小依赖:openai 负责调用兼容接口,python-dotenv 读取本地配置,chromadb 保存和检索向量,pytest 执行自动化测试。

bash
python -m pip install openai python-dotenv chromadb pytest
python -c "import openai, chromadb, dotenv; print('dependencies ready')"
python -m pip freeze > requirements.txt

预期输出

text
dependencies ready

安装过程中的下载日志会因平台而异,以导入检查成功且生成 requirements.txt 为准。后续可执行 python -m pip install -r requirements.txt 在其他环境复现依赖。

规划项目目录

目录应按职责拆分,而不是把配置、业务逻辑和测试都放在一个文件中。下面的命令同时创建包目录、示例配置和 Git 忽略规则。

bash
mkdir -p app/config app/data app/index app/service tests
touch app/__init__.py app/config/__init__.py app/index/__init__.py app/service/__init__.py
touch .env.example
printf ".venv/\n.env\n__pycache__/\n.pytest_cache/\n" > .gitignore
find . -maxdepth 2 -type d | sort

预期输出

text
.
./.venv
./app
./app/config
./app/data
./app/index
./app/service
./tests

app/config 管理环境变量,app/data 放原始或处理后的文档,app/index 封装向量索引,app/service 编排检索与生成流程,tests 保存测试。真实密钥写入 .env,只提交不含敏感值的 .env.example。

验收项目骨架

环境完成后,应同时满足三个条件:解释器路径位于 .venv,核心包能够导入,目录职责与忽略规则已经就位。若 find 命令在 Windows 不可用,可在资源管理器或 IDE 中按同名结构创建,并用 Get-ChildItem -Recurse -Directory 检查。

本课总结

  • 虚拟环境隔离了项目依赖,避免污染系统 Python
  • requirements.txt 让同一套依赖可以被重复安装
  • 配置、数据、索引、服务和测试分目录后,后续代码更容易维护

下一课预告

下一课将读取本地模型配置,发送第一条对话请求,并为超时、网络失败和服务端错误建立统一处理方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建项目环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通