Heurist Agent Framework

Heurist Agent Framework

site icon
2025.04.18 475
PythonAI代理框架多平台交互知识库管理工作流自动化开发效率交流协作
Heurist Agent Framework 是一个灵活的多接口AI代理框架,支持通过Telegram、Discord、Twitter、Farcaster、REST API和MCP等多种平台进行交互。该框架基于模块化架构,能够处理文本和语音消息、生成图像和视频、跨平台交互、访问外部API和工具,并支持知识库的存储和检索。
View on GitHub

Overview

基本能力

产品定位

Heurist Agent Framework 是一个多接口AI代理框架,旨在通过模块化架构支持多种平台的交互和复杂工作流的构建。

核心功能

  • 模块化代理框架:支持高级LLM集成和组件化设计。
  • 多平台交互:支持Telegram、Discord、Twitter、Farcaster、REST API和MCP。
  • 媒体处理:支持图像生成和语音处理(转录和文本转语音)。
  • 知识库支持:支持PostgreSQL和SQLite作为向量存储。
  • 工具集成:支持MCP协议和外部API的集成。
  • 工作流系统:支持RAG、Chain of Thought和Research工作流。

适用场景

  • 多平台自动化:通过单一代理管理多个社交平台或通讯工具的交互。
  • 知识检索与分析:利用知识库和外部API进行数据分析和报告生成。
  • 媒体生成与处理:生成图像或处理语音消息。
  • 复杂工作流构建:通过模块化组件构建定制化的工作流。

工具列表

  • BitquerySolanaTokenInfoAgent:提供Solana代币的全面分析。
  • CoinGeckoTokenInfoAgent:从CoinGecko获取代币信息和市场数据。
  • DexScreenerTokenInfoAgent:获取多链DEX实时交易数据。
  • ElfaTwitterIntelligenceAgent:分析Twitter数据和智能影响者。
  • ExaSearchAgent:提供直接答案的网页搜索。
  • GoplusAnalysisAgent:分析区块链代币合约的安全细节。
  • MetaSleuthSolTokenWalletClusterAgent:分析Solana代币钱包集群。
  • PumpFunTokenAgent:跟踪Pump.fun代币的创建和毕业事件。
  • SolWalletAgent:查询Solana钱包资产和交易记录。

常见问题解答

  • 如何获取Heurist API Key:使用代码'agent'在https://heurist.ai/dev-access提交表单。
  • 如何贡献Mesh Agent:参考Mesh README的指南。
  • 如何报告问题:使用GitHub Issues模板提交问题。

使用教程

使用依赖

安装前需确保系统已安装Python 3.8+和pip。

# 检查Python版本
python3 --version

# 安装pip(如未安装)
sudo apt-get install python3-pip

安装教程

  1. 克隆仓库:
git clone https://github.com/heurist-network/heurist-agent-framework.git
cd heurist-agent-framework
  1. 安装依赖:
pip install -r requirements.txt
  1. 配置环境变量:
cp .env.example .env
# 编辑.env文件配置API密钥和其他设置

调试方式

  1. 启动Telegram代理:
python3 interfaces/telegram_agent.py
  1. 检查日志输出:
tail -f logs/agent.log
  1. 测试REST API:
curl -X POST http://localhost:5000/api/v1/query -H "Content-Type: application/json" -d '{"query":"Hello"}'

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。