OpenHealth项目安装与配置指南

OpenHealth项目安装与配置指南

1. 项目基础介绍

OpenHealth 是一个开源的 AI 健康助手项目，旨在帮助用户更好地理解和管理工作中的健康数据。它通过利用 AI 技术和用户的个人健康信息，提供了一个私人的助手，可以在最大程度上保护隐私的情况下运行。

该项目主要使用的编程语言是 TypeScript。

2. 关键技术与框架

• 数据解析: 项目包括一个数据解析器，用于自动分析健康数据并生成结构化数据文件。
• AI 交互: 使用了多种语言模型（如 LLaMA、DeepSeek-V3、GPT、Claude、Gemini）来支持智能对话。
• 前端框架: 使用 Next.js 进行前端开发。
• 后端框架: 使用了 TypeORM 作为 ORM 工具。
• 数据存储: 使用 Prisma 进行数据库操作。
• 容器化: 使用 Docker 进行容器化部署。

3. 安装与配置准备工作

在开始安装前，请确保您的系统中已经安装了以下工具：

• Docker 或 Podman
• Git
• Node.js 和 npm 或 yarn

3.1. 克隆项目

首先，需要从 GitHub 上克隆项目到本地：

git clone https://github.com/OpenHealthForAll/open-health.git
cd open-health

3.2. 配置环境变量

复制 .env.example 文件为 .env 并填写相应的环境变量：

cp .env.example .env

在 .env 文件中，您可能需要设置如下变量：

• ENCRYPTION_KEY: 加密密钥，可以通过以下命令生成并添加到文件中：

echo $(head -c 32 /dev/urandom | base64) > .env

3.3. 使用 Docker 或 Podman 启动项目

使用以下命令启动项目：

docker/podman compose --env-file .env up

如果需要重建镜像（比如修改了 .env 文件之后），可以使用以下命令：

docker/podman compose --env-file .env up --build

3.4. 访问项目

启动成功后，在浏览器中访问 http://localhost:3000 即可开始使用 OpenHealth。

请注意，项目可能包含两个主要组件：解析器和 LLM（语言模型）。对于解析器，可以使用 docling 实现完全本地执行，而 LLM 组件也可以使用 Ollama 实现完全本地运行。如果是通过 Docker 使用 Ollama，确保设置正确的 API 端点：

• Mac: http://docker.for.mac.localhost:11434
• Windows: http://host.docker.internal:11434

以上就是 OpenHealth 项目的详细安装和配置指南，按照上述步骤操作即可完成安装。