Delphic

Delphic 项目介绍

什么是 Delphic？

Delphic 是一个旨在使用 LlamaIndex 构建和部署大型语言模型（LLM）代理的简单框架，这些代理可以用于分析和处理文档中的文本数据。这一框架为开发者提供了一个利用大型语言模型能力的基础，能够高效处理文本，同时也便于自定义和扩展。

技术背景

Delphic 的初始版本仅基于 OpenAI 的 API。虽然目前仅支持 OpenAI，但未来计划支持其他大型语言模型，无论是自托管的还是由第三方 API 提供支持的。尽管如此，依然兼容 Langchain，从而能够轻松转换至其他 LLM。不过，目前用户在使用此工具时，仍需通过 OpenAI 处理文本。如果 OpenAI 的服务条款对用户而言存在潜在问题，则需要自行解决。

如何本地启动

1. 克隆仓库：首先需要从Git仓库中克隆代码。

   git clone
   cd delphic

2. 复制环境配置文件：将样本环境文件复制到本地目录。

   mkdir -p ./.envs/.local/
   cp -a ./docs/sample_envs/local/.frontend ./frontend
   cp -a ./docs/sample_envs/local/.django ./.envs/.local
   cp -a ./docs/sample_envs/local/.postgres ./.envs/.local

3. 更新配置：编辑 .django 配置文件并添加您的 OpenAI API 密钥。您可能还需要修改 .postgres 以为数据库用户设置一个唯一的密码。

4. 构建 Docker 镜像：使用 Docker Compose 构建应用所需的镜像。

   sudo docker-compose --profile fullstack -f local.yml build

5. 启动应用：运行以下命令启动应用。

   sudo docker-compose --profile fullstack -f local.yml up

   访问 localhost:3000 查看前端界面。

用户设置

为了使用应用程序，用户需要登录。可以创建超级用户（有完整权限）或普通用户。目前，任何登录用户都会有完整权限，未来计划实现基于角色的访问控制。

1. 创建超级用户：

   sudo docker-compose -f local.yml run django python manage.py createsuperuser

2. 设置额外用户（如需要）：

   • 启动 Delphic 应用并在浏览器中访问 http://localhost:8000/admin。
   • 使用超级用户登录后，可以在“Users”部分添加新用户，并配置权限。

应用使用

通过 Delphic，可创建和查询文本 "集合"。请注意，使用 OpenAI 进行查询会消耗 API 积分，并可能产生费用。用户应根据自己的使用场景自行承担相应条款。

开发环境设置

后端设置

为开发 Delphic 或自定义版本，需配置开发环境。后端需要一个工作良好的 Python 环境来运行代码格式检查，推荐使用 Python 3.10 或更高版本。

1. 安装依赖并设置 Pre-Commit：

   pip install -r ./requirements/local.txt
   pre-commit install

2. 运行测试：

   sudo docker-compose -f local.yml run django python manage.py test

前端设置

前端使用 Node v18.15.0。假设使用 nvm 来管理 Node 版本。

1. 启动前端开发服务器：

   cd frontend
   nvm use
   npm install yarn
   yarn install
   yarn start

   前端开发服务器将在 http://localhost:3000 运行，同时需要启动后端才能正常工作。

Delphic 提供了一个创新的平台，利用现代大型语言模型实现文本分析和处理，适合希望在此领域快速搭建应用的开发者和团队。