Loki：一款开源的事实核查工具

概述

Loki 是我们开发的一款开源解决方案，旨在自动化事实核查流程。它提供了一个完整的流水线，能够将长文本拆解为单个声明，评估这些声明是否值得核查，生成用于证据搜索的查询，抓取相关证据，并最终完成对声明的验证。这款工具尤其适用于记者、研究人员以及所有关注信息真实性的人士。如需获取最新动态，请订阅我们的新闻通讯 点击这里 或加入我们的 Discord 社区！

快速入门

克隆仓库并进入项目目录

git clone https://github.com/Libr-AI/OpenFactVerification.git
cd OpenFactVerification

使用 Poetry 安装（方法一）

1. 按照 安装指南 安装 Poetry。
2. 运行以下命令安装所有依赖：

poetry install

使用 pip 安装（方法二）

1. 创建 Python 3.9 或更高版本的虚拟环境并激活。

2. 进入项目目录，安装所需的包：

pip install -r requirements.txt

配置 API 密钥

您可以选择将必要的 API 密钥导出到环境变量中：

• 示例：导出必要的 API 密钥到环境变量

export SERPER_API_KEY=... # 如果使用 Serper 进行证据检索，则需要此密钥
export OPENAI_API_KEY=... # 所有任务都需要此密钥

或者，您也可以通过 YAML 文件配置 API 密钥，更多详情请参阅 用户指南。

一个示例测试用例：

使用方法

Loki 事实核查工具的主要接口位于 factcheck/__init__.py 中，其中包含 check_response 方法。该方法集成了完整的事实核查流水线，每个功能模块都封装在其对应的类中，具体说明见“功能特性”部分。

作为库使用

from factcheck import FactCheck

factcheck_instance = FactCheck()

# 示例文本
text = "您的文本在此"

# 运行事实核查流水线
results = factcheck_instance.check_response(text)
print(results)

作为 Web 应用运行

python webapp.py --api_config demo_data/api_config.yaml

多模态使用

# 文本输入
python -m factcheck --modal string --input "MBZUAI 是世界上第一所人工智能大学"
# 文本文件输入
python -m factcheck --modal text --input demo_data/text.txt
# 语音输入
python -m factcheck --modal speech --input demo_data/speech.mp3
# 图片输入
python -m factcheck --modal image --input demo_data/image.webp
# 视频输入
python -m factcheck --modal video --input demo_data/video.m4v

自定义体验

如需高级用法，请参阅我们的 用户指南。

试用我们的在线服务

随着我们不断迭代和完善事实核查解决方案，我们诚挚邀请您成为我们旅程中不可或缺的一部分。注册支持者版不仅能让您解锁一系列高级功能与权益，还能助力我们打造更加可信的信息生态。

以下是我们的在线服务截图。 立即点击试用！

贡献 Loki 项目

欢迎并对您对 Loki 项目的兴趣表示感谢！我们热烈欢迎社区的贡献与反馈。如需开始参与，请参考我们的 贡献指南。

致谢

• 特别感谢所有为该项目做出贡献的伙伴们。

保持联系，了解最新动态

不要错过我们的最新更新、功能发布和社区洞察！诚邀您订阅我们的新闻通讯，加入我们不断壮大的社区。

💌 现在就访问 我们的官网 订阅吧！

星标历史

引用方式

@misc{li2024lokiopensourcetoolfact,
      title={Loki：一款开源的事实核查工具}, 
      author={Haonan Li 和 Xudong Han 和 Hao Wang 和 Yuxia Wang 和 Minghan Wang 和 Rui Xing 和 Yilin Geng 和 Zenan Zhai 和 Preslav Nakov 和 Timothy Baldwin},
      year={2024},
      eprint={2410.01794},
      archivePrefix={arXiv},
      primaryClass={cs.CL},
      url={https://arxiv.org/abs/2410.01794}, 
}

OpenFactVerification (Loki) 快速上手指南

Loki 是一款开源的事实核查自动化工具，能够将长文本拆解为独立主张，自动搜索证据并验证其真实性。适用于记者、研究人员及关注信息真实性的开发者。

环境准备

• 操作系统：Linux / macOS / Windows
• Python 版本：3.9 或更高版本
• 依赖管理工具（任选其一）：
  • Poetry（推荐）
  • pip
• API Keys：
  • OPENAI_API_KEY：所有任务必需
  • SERPER_API_KEY：若使用 Serper 进行证据检索则必需

安装步骤

1. 克隆项目

git clone https://github.com/Libr-AI/OpenFactVerification.git
cd OpenFactVerification

2. 安装依赖

方式一：使用 Poetry（推荐）

# 确保已安装 Poetry
poetry install

方式二：使用 pip

# 创建并激活 Python 3.9+ 虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

3. 配置 API Key

方法 A：环境变量（推荐用于快速测试）

export OPENAI_API_KEY="your_openai_key"
export SERPER_API_KEY="your_serper_key"

方法 B：YAML 配置文件 详见 用户指南，通过 api_config.yaml 统一管理密钥。

基本使用

作为 Python 库调用

这是最基础的用法，直接对文本进行事实核查：

from factcheck import FactCheck

# 初始化实例
factcheck_instance = FactCheck()

# 待核查文本
text = "MBZUAI is the first AI university in the world"

# 运行核查流程
results = factcheck_instance.check_response(text)
print(results)

命令行多模态测试

支持字符串、文本文件、语音、图片和视频输入：

# 字符串输入
python -m factcheck --modal string --input "MBZUAI is the first AI university in the world"

# 文本文件
python -m factcheck --modal text --input demo_data/text.txt

# 语音文件
python -m factcheck --modal speech --input demo_data/speech.mp3

# 图片文件
python -m factcheck --modal image --input demo_data/image.webp

# 视频文件
python -m factcheck --modal video --input demo_data/video.m4v

启动 Web 应用

python webapp.py --api_config demo_data/api_config.yaml