PYTHIA

PYTHIA 是一个开源的预言机系统，旨在通过融合实时全球数据与本地大语言模型（LLM），实现对未来事件的概率化预测。该系统完全运行在用户本地硬件上，无需云端依赖、API 密钥或订阅费用，为开发者和研究人员提供了一个私密的态势感知工具。

核心架构：眼、脑、声的协同

PYTHIA 整合了两个现有的开源项目，构建了一个完整的情报处理闭环：

• Osiris（眼睛）：作为实时全球情报仪表盘，Osiris 提供 3D 地球可视化界面，并流式传输超过 30 个免费且无密钥的数据源，包括突发新闻、GDELT 地缘政治数据、武装冲突动态、气象预警（NWS/EONET）、地震、野火、网络威胁及 Polymarket 群体概率等。
• MiroFish（大脑）：作为一个群体智能预测引擎，MiroFish 模拟由多个自主智能体组成的平行世界。在 PYTHIA 中，它驱动一个“本地群体”——由四位专业角色组成的委员会，对预测进行审议，输出共识与异议。
• 本地 LLM（声音）：通过 Ollama 运行的本地模型读取整合后的世界状态简报，生成带有概率和推理依据的预测，并支持用户在界面中自由切换模型。

主要功能

1. 多时间跨度预测：系统生成未来 24 小时、一周、一个月及一年的走势预测，每个预测均附带发生概率、推理逻辑及地理位置。
2. 群体审议机制：通过模拟专家委员会的辩论，呈现预测的共识度与分歧点，帮助用户识别高风险或不确定性较高的事件。
3. 全源情报观察：实时监控全球冲突前线、自然灾害、市场波动及社会动荡，并在地图上以风险叠加层形式展示。
4. 交互式控制台：UI 设计为可移动、可调整大小的窗口组合，用户可以在旋转地球仪的同时查看新闻源、聊天窗口及预测面板。
5. 机器可读 API：通过 http://localhost:8088 提供干净的 JSON 接口，允许外部 AI 智能体获取实时的世界观摘要、事件分组及预测数据，从而为决策提供现实背景。

工作流程

1. 感知：引擎持续拉取并融合所有实时数据源，生成世界简报。
2. 草稿：本地 LLM 读取简报，起草具体、带位置的预测。
3. 审议：角色委员会对预测进行重新评分，计算共识与异议。
4. 呈现：结果在 UI 面板和地球仪上展示，支持点击跳转至相关位置查看完整审议过程。
5. 服务：通过 Agent API 向外部工具开放整个世界观数据。

安装与运行

PYTHIA 依赖于 Ollama 和本地 Python 环境。

前提条件：

• 已安装并运行 Ollama，且拉取了至少一个聊天模型。
• Python 3.11+ 及 uv 包管理器。

快速启动：

git clone https://github.com/jangles-byte/Pythia && cd Pythia
cp .env.example .env          # 使用默认配置，无需额外密钥
./run-all.sh                  # 启动 Osiris + 引擎并打开 UI

验证服务状态：

curl http://localhost:8088/health
curl http://localhost:8088/links     # 确认 engine, osiris, oracle 均为 true

智能体集成示例：

curl http://localhost:8088/agent/view

该接口返回包含世界文字摘要、实时事件分组及当前预测的 JSON 负载，可直接嵌入到其他 AI 应用的工作流中。