alexle135/agora-agora

Agora

本地优先、云兼容的基于角色的共鸣模拟器。
Agora接收文档，构建知识图谱，生成智能体角色，模拟类社交媒体讨论动态，并生成结构化报告。它主要使用Neo4j和Ollama运行，也可使用OpenAI兼容端点。https://github.com/arn0ld87/agora

功能介绍

• 上传PDF、Markdown或文本文档。
• 提取实体和关系到Neo4j知识图谱。
• 模拟开始前生成和审查角色。
• 模拟社交动态和公众反应流程。
• 生成带可选实时网络上下文的证据支持报告。
• 以多种格式导出报告和图谱相关制品。

包含的技术栈

• 前端：基于Vite的Web界面。
• 后端：Flask API。
• 图数据库：Neo4j 5.18+。
• LLM运行时：默认Ollama，支持OpenAI兼容端点。
• 事件传输：Docker Compose中默认使用Redis，支持文件回退。

当前状态

Agora是一个活跃的实验性分支，不适合公开互联网暴露。在不利的模型/API条件下，图谱构建、模拟和报告生成仍可能失败。当前文档化版本为v0.9.0，main分支已包含额外的0-5层重构工作。

快速开始

bash
docker pull alexle135/agora-agora:latest

如需完整的多容器设置，请使用上游项目仓库和Docker Compose：

bash
git clone https://github.com/arn0ld87/agora.git
cd agora
cp .env.example .env
docker compose up -d --build

启动后的默认本地端点：

• 前端：http://localhost:5173
• 后端健康检查：http://localhost:5001/health
• Neo4j浏览器：http://localhost:7474

重要环境变量

env
LLM_BASE_URL=http://localhost:11434/v1
LLM_MODEL_NAME=qwen2.5:32b

NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=agora

EMBEDDING_MODEL=qwen3-embedding:4b
VECTOR_DIM=2560

AGENT_LANGUAGE=de
REPORT_LANGUAGE=German
TIME_PROFILE=dach_default

ENABLE_AGENT_TOOLS=false
MAX_TOOL_CALLS_PER_ACTION=2

这些默认值在项目README中有详细说明，包括当前维护的嵌入路径（使用qwen3-embedding:4b和VECTOR_DIM=2560）。

安全注意事项

Agora仅设计用于本地主机或可信私有网络。可选的令牌保护和限制性CORS默认设置可减少暴露，但不能使其成为安全的公共多用户部署。请勿直接将其暴露到互联网。

主要功能

• GraphRAG风格的文档摄入管道。
• 灵活的本体生成。
• 模拟前的角色审查、编辑和批准。
• 运行仪表板和模拟控制。
• 基于证据和置信度的报告生成。
• 用于报告增强的可选网络工具。
• 报告、指标和图谱资产的导出中心。

许可证

AGPL-3.0。

来源

GitHub：https://github.com/arn0ld87/agora