功能特性

  • 多平台支持:TikTok、Instagram、Twitter/X、Facebook、YouTube、LinkedIn
  • 智能工具选择:自动选择最优的抓取方法
  • 全面分析:内容提取、论断识别、交叉核验、结论综合
  • 权威来源:对照新闻网站、事实核查机构与官方来源进行验证
  • 置信度评分:基于证据给出结论,并提供透明的解释

演示


FactFlux Demo Video

点击观看 FactFlux 实际运行演示

先决条件

  • Python 3.8+
  • 有效的 API Key:
    • Google Gemini
    • Bright Data

安装

  1. 克隆仓库
    git clone https://github.com/MeirKaD/FactFlux.git
    cd FactFlux
  2. 创建虚拟环境
    python -m venv venv
    source venv/bin/activate # On Windows: venvScriptsactivate
  3. 安装依赖
    pip install -r requirements.txt
  4. 配置环境变量
    cp .env.example .env
    # Edit .env with your API keys

配置

创建一个包含 API Key 的 .env 文件:

GOOGLE_API_KEY=your_google_gemini_api_key_here
BRIGHT_DATA_API_KEY=your_bright_data_api_key_here

使用方法

Playground 模式(推荐)

python playground_fact_check.py

架构

智能体团队结构

  1. 内容提取智能体(Content Extractor Agent)
    • 使用最优的 Bright Data 工具提取帖子数据
    • 自动处理多平台
  2. 论断识别智能体(Claim Identifier Agent)
    • 识别可验证的事实性论断
    • 区分事实与观点/讽刺内容
  3. 交叉核验智能体(Cross-Reference Agent)
    • 对照权威来源验证论断
    • 执行反向媒体搜索
  4. 结论智能体(Verdict Agent)
    • 综合证据并给出最终结论
    • 提供置信度评分与推理依据

工作流程

URL Input Content Extraction Claim Identification Cross-Reference Final Verdict

技术栈

  • Agno
  • Gemini

支持的平台

  • TikTok
  • Instagram
  • Twitter/X
  • Facebook
  • YouTube
  • LinkedIn

错误处理

系统包含全面的错误处理,覆盖:

  • 无效 URL
  • 网络故障
  • API 速率限制
  • 格式异常的社交媒体帖子
  • 内容缺失

参与贡献

  1. Fork 本仓库
  2. 创建功能分支(git checkout -b feature/amazing-feature
  3. 提交改动(git commit -m 'Add amazing feature'
  4. 推送到分支(git push origin feature/amazing-feature
  5. 发起 Pull Request

许可证

本项目使用 MIT License 许可——详情请参阅 LICENSE 文件。

支持

  • 查看日志以获取详细错误信息
  • 确保所有 API Key 有效且有足够额度
  • 确认社交媒体 URL 可公开访问
  • 核对支持的平台列表

更新

  • 检查 Agno 框架更新:pip install -U agno
  • 关注 Bright Data API 变更
  • 在配置中保持模型版本为最新

注意:本系统用于教育与研究目的。请始终遵守各平台服务条款与速率限制。