olivia

环境要求

• 已安装并启动 Docker 环境
• 宿主机有可用端口（示例使用 8080）
• 网络可访问 docker.pkg.github.com 拉取镜像

安装与启动步骤

1. 1拉取 Olivia 镜像

   从 GitHub Packages 拉取官方最新镜像，镜像名必须写全，否则会找不到仓库。

   docker pull docker.pkg.github.com/olivia-ai/olivia/olivia:latest

   复制

2. 2启动 Olivia 容器

   以守护模式运行，用 -e PORT 指定应用端口，-p 把端口映射到宿主机，两者要保持一致。

   docker run -d -e PORT=8080 -p 8080:8080 docker.pkg.github.com/olivia-ai/olivia/olivia:latest

   复制

3. 3查看容器与端口

   列出运行中的容器，确认 Olivia 处于 Up 状态并看到 8080 端口映射，同时记下容器 ID 备用。

   docker container ls

   复制

4. 4通过 WebSocket 对话

   容器启动后即可直接使用 Olivia 的 WebSocket 接口进行对话，无需额外云服务或密钥。

5. 5停止 Olivia

   把命令末尾的 ID 换成上一步查到的真实容器 ID（示例为 311b3abb963a）即可停止服务。

   docker container stop 311b3abb963a

   复制

6. 6重新训练模型

   删除神经网络存档文件 res/datasets/training.json 后重新运行应用，Olivia 会自动重新训练模型。

关键配置

如何确认成功

执行 docker container ls，能看到 olivia 容器状态为 Up，端口显示 0.0.0.0:8080->8080/tcp，即可通过 WebSocket 连接对话。

常见问题

注意事项

• README 只给出了 Docker 这一种安装方式，未提供从源码编译 Go 项目的步骤。
• 应用启动时会自动检查 res/datasets/training.json，从 GitHub 克隆仓库时该文件自带稳定模型存档。
• -e PORT 与 -p 端口映射必须保持一致，示例统一使用 8080。