本地开发安装使用

开发部署，安装的Python环境

Conda环境安装

Mac安装

# 直接homebrew
brew install conda

conda env list
# conda environments:
#
base                  *  ~/miniconda3

下一步

# 创建一个新的env, 并且安装python版本
conda create -n brainx python==3.12.1

# 激活环境
conda activate brainx

#查看python版本
python --version
Python 3.12.1

Poetry 项目包版本管理

基于当前conda的env，我们可以用poetry来操作依赖包

# 然后基于当前激活的conda env，安装poetry
pip install poetry==1.8.2

# 确保poetry可以被shell环境识别
which poetry
~/miniconda3/envs/brainx/bin/poetry

# 激活 Virtual Environment
poetry shell

# 如果网络有问题，你需要用点发自下载安装包

Alembic数据库迁移版本配置

cp alembic.example.ini alembic.ini

修改配置 将{xxx}换成你的配置信息

sqlalchemy.url = postgresql://{username}:{password}@localhost/{brain_x}

需要创建新的表

# 比如需要添加一个MediaResource对象
alembic revision -m "Add MediaResource model" 


# migrate 你的定义
alembic upgrade head
# 或者
alembic upgrade <revision_number>

# 执行的时候，输出sql语句
alembic upgrade head --sql

# 撤回一步
alembic downgrade -1

# 撤回到base，慎用，特别是表里有你自己的业务数据，请先备份数据库
alembic downgrade base

Ollama

ollama install

• windows/mac直接下载安装包

启动或查看日志，运行

ollama serve

Minio 存储对象方案

mac

brew install minio

设置账号密码

cat ~/.minio/config.json
{
  "version": "9",
  "credential": {
    "accessKey": "brainx_access_key",
    "secretKey": "brainx_secret_key"
  },
  "region": "AsiaShanghai",
  "browser": true
}
 

启动项目

# 使用python 直接启动
poetry run python app.py

# 或者使用makefile启动
make run

启动Celery worker

# 单个worker，跑在自己定义的队列rag_queue
celery -A app.service.task.celery_app worker -Q rag_queue --loglevel=info

# mac 上使用，跑在自己定义的队列rag_queue
celery -A app.service.task.celery_app worker -Q rag_queue --loglevel=info  -P eventlet


# 并发多个worker， 比如并发4个
celery -A app.service.task.celery_app worker --loglevel=info --concurrency=4