fikriaf/TAHRIX

### Agentic AI 区块链网络情报平台 []() []() []() []()

## 概述 TAHRIX 为安全分析师和合规团队提供支持，利用 AI 驱动的自动化技术来调查加密货币钱包和交易。该平台能够自主构建假设、跨多个区块链执行调查，并生成风险评估报告。 ### 核心功能 | 功能 | 描述 | |---------|-------------| | **Agentic AI 调查** | 无需人工干预即可进行端到端调查的自主 AI Agent | | **多链支持** | 跨 Ethereum、Solana、Base、Polygon 和 BNB Chain 的统一分析 | | **图神经网络** | 基于 ONNX 的 GNN 模型，用于检测非法交易模式 | | **实时 OSINT** | 集成的网络和社交媒体情报收集 | | **制裁筛查** | OFAC 和合规数据库检查 | | **风险评分** | 结合 GNN、异常检测和中心性指标的多因素风险评估 | ## 架构  ## 技术栈 | 层级 | 技术 | |-------|------------| | **API** | FastAPI, Pydantic, SQLAlchemy | | **Workers** | Celery, asyncio | | **数据库** | PostgreSQL, Neo4j | | **缓存/队列** | Redis | | **AI/ML** | OpenAI SDK, ONNX Runtime, GNN (GAT) | | **搜索** | Exa AI, DuckDuckGo | | **Frontend** | Vanilla JS, D3.js | ## 快速开始 ### 前置条件 - Docker & Docker Compose - PostgreSQL, Neo4j, Redis (通过 Docker) - API 密钥: Alchemy, Helius, Etherscan, Exa AI, OpenCode Zen ### 安装 ``` # Clone repository git clone https://github.com/fikriaf/TAHRIX.git cd TAHRIX/backend # 复制环境模板 cp .env.example .env # 使用你的 API keys 编辑 .env # 必需：LLM_API_KEY, ALCHEMY_API_KEY, NEO4J_PASSWORD 等。 # 启动所有服务 docker compose up --build ``` ### 访问 | 服务 | URL | |---------|-----| | API 文档 | `http://localhost:8000/docs` | | Frontend | `http://localhost:8000` (或配置的公共 URL) | ## 配置 `.env` 中的主要环境变量： | 变量 | 描述 | 是否必填 | |----------|-------------|----------| | `LLM_API_KEY` | OpenCode Zen API 密钥 | 是 | | `LLM_BASE_URL` | LLM endpoint | 是 | | `LLM_MODEL` | 模型名称 (例如, `minimax-m2.5-free`) | 是 | | `ALCHEMY_API_KEY` | Ethereum/Polygon 数据 | 是 | | `HELIUS_API_KEY` | Solana 数据 | 是 | | `NEO4J_PASSWORD` | Neo4j 数据库密码 | 是 | | `EXA_API_KEY` | 用于 OSINT 的网络搜索 | 否 | ## API 端点 ### 调查案例 ``` POST /api/v1/cases # Start new investigation GET /api/v1/cases # List all cases GET /api/v1/cases/{id} # Get case details GET /api/v1/cases/{id}/events # Stream investigation events (SSE) GET /api/v1/cases/{id}/graph # Get wallet graph POST /api/v1/cases/{id}/report # Generate PDF report ``` ### Tahrix Agent ``` POST /api/v1/agent/chat # Chat with AI agent ``` ### 地址解析 ``` POST /api/v1/resolve # Resolve blockchain addresses GET /api/v1/labels # Get intel labels ``` ## 演示

该平台提供： - 通过 Server-Sent Events 提供实时调查进度 - 交互式钱包关系图可视化 - 结合 GNN 置信度的多因素风险评分 - 全面的事件日志和审计追踪 - 生成用于合规的 PDF 报告 ## 项目结构 ``` TAHRIX/ ├── backend/ # Python FastAPI application │ ├── app/ │ │ ├── core/ # Configuration, logging, exceptions │ │ ├── db/ # Database clients (Postgres, Neo4j, Redis) │ │ ├── models/ # SQLAlchemy + Pydantic schemas │ │ ├── repositories/ # Data access layer │ │ ├── adapters/ # External API clients │ │ ├── services/ # Domain services (risk, GNN, anomaly) │ │ ├── agent/ # Agentic AI orchestrator + tools + memory │ │ ├── api/v1/ # REST endpoints │ │ └── workers/ # Celery tasks │ ├── ml/ # GNN training + ONNX export │ └── tests/ # Test suite ├── frontend/ # Single-page application │ └── index.html # Dashboard UI ├── skills/ # Claude Code installable skills │ └── tahrix-agent/ # LLM streaming + tool calling + frontend rendering ├── demo/ # Demo screenshots └── agentic_ai_architecture.svg # System architecture diagram ``` ## Claude Code 技能 安装 TAHRIX Agent 的 Claude Code 技能，以复用流式传输 + 工具调用 + 基于流程的前端渲染模式： ``` npx skills add https://github.com/fikriaf/TAHRIX --skill tahrix-agent ``` 详情请参阅 [`skills/tahrix-agent/SKILL.md`](skills/tahrix-agent/SKILL.md)。 ## 部署 TAHRIX 通过 Docker 部署在云服务器上。 | 服务 | 端点 | |---------|----------| | API | `https://tahrix.serveousercontent.com` | | 公网访问 | 通过反向代理 (Traefik/Caddy) | ### 生产环境注意事项 - 使用带连接池的 PostgreSQL - 为图存储启用 Neo4j 因果集群 - 使用专用 worker 池配置 Celery - 设置监控 (Prometheus, Grafana) - 为所有外部连接启用 TLS/HTTPS ## 许可证 本项目基于 MIT 许可证授权。 ## 作者 **Fikri Armia Fahmi** 区块链基础 Universitas Pembangunan Jaya

标签：Agentic AI, AML, AV绕过, Base, BNB Chain, Celery, DLL 劫持, ESC4, Ethereum, FastAPI, GAT, GNN, IP 地址批量处理, Neo4j, OFAC, ONNX, OSINT, Polygon, PostgreSQL, Python, Redis, Solana, Web3, 人工智能, 制裁筛查, 加密货币合规, 加密货币犯罪调查, 加密货币追踪, 区块链安全, 反洗钱, 图注意力网络, 图神经网络, 多链分析, 大语言模型, 实时处理, 密码管理, 搜索引擎查询, 无后门, 智能体 AI, 测试用例, 用户模式Hook绕过, 系统分析, 网络分析, 网络威胁情报, 网络安全, 自动报告生成, 请求拦截, 逆向工具, 链上分析, 隐私保护