How heurist-network/heurist-agent-framework works
Project Type and Purpose
• The Heurist Agent Framework is a modular, multi-interface AI agent platform. Its purpose is to process text/voice, generate images and videos, and interact on various platforms (Telegram, Discord, Twitter, Farcaster, REST API, and more).
• It is built to leverage a “mesh” of specialized agents (the Mesh section) that can interact and compose workflows (similar to modular smart contracts in DeFi) and easily integrate with external systems via MCP and other clients.
File Structure
• Key directories include:
• core: Contains the core logic, configuration, LLM integration, utilities (like image and video generation).
• agents: Implements base functionalities for core agents, research agents, and tool-decorators.
• interfaces & platforms: Provide platform-specific implementations (Discord, Telegram, Twitter, Farcaster, REST API) that interact with the core agent.
• mesh: Houses a collection of specialized agent scripts. These “Mesh Agents” extend functionality by offering specific processing (e.g., token info, search agents, analytics).
• clients: Contains API client implementations for external services (e.g., Defillama, MCP client, Merkl, etc.).
• config: Manages configuration files (e.g., YAML prompts) to drive agent behavior.
• examples & docs: Offer usage examples and documentation.
• There are multiple main entry point scripts (e.g., main_api.py, main_discord.py, etc.) that launch agents on different interfaces, indicating separate runtime components communicating with the same core.
Essential Elements
• From external platforms to the Core Agent.
• From the Core Agent to Mesh Agents.
• Between the Core Agent and external API clients.