heurist agent framework

Report Abuse

Basic Information

Heurist Agent Framework is a modular, multi-interface AI agent framework designed to build and run LLM-powered agents that interact across platforms and compose complex workflows. It provides a core agent abstraction and concrete implementations that process text and voice, generate images and video, access knowledge stored in vector databases (Postgres and SQLite supported), and call external tools and APIs. The framework integrates a community-run Heurist Mesh of specialized agents accessible via a unified REST API and MCP, enabling agents to combine capabilities from many contributors. It includes components for personality, knowledge retrieval, conversation history, validation, media handling, and LLM access, plus workflow patterns for retrieval-augmented generation, chain-of-thought reasoning, and deep research. The repo also contains multiple platform interfaces such as Telegram, Discord, Twitter, Farcaster and a REST API and provides tooling and clients to develop, extend, and deploy agentic applications.

Links

Categorization

App Details

Features
The repository documents a component-based architecture with a BaseAgent and CoreAgent, plug-and-play components (PersonalityProvider, KnowledgeProvider, ConversationManager, ValidationManager, MediaHandler, LLMProvider, MessageStore) and a toolbox for defining and registering tools. It supports workflows including AugmentedLLMCall (RAG+tools), ChainOfThoughtReasoning, and ResearchWorkflow. Media capabilities include image creation, video and audio transcription and text-to-speech. Persistence and retrieval are supported with vector storage on PostgreSQL or SQLite. The Heurist Mesh supplies many community agents (examples include token info, wallet analysis, web search and Twitter intelligence) accessible via REST or MCP. External clients such as SearchClient and MCPClient are provided. MCP support enables use with local or remote MCP servers and common MCP-capable clients. Development setup and contribution guidelines, issue templates, and bounty workflows are included to facilitate extension.
Use Cases
This framework helps developers and teams rapidly assemble agentic applications by providing reusable components, standard workflows, and multi-platform interfaces so the same agent logic can run on Telegram, Discord, Twitter, Farcaster or a REST API. Built-in knowledge retrieval, vector storage and RAG workflows let agents produce context-aware responses while media and voice handlers enable multimodal features. The Mesh and MCP integrations let applications leverage community-contributed specialized agents for tasks like token analysis, web search, wallet inspection, and other domain skills without reimplementing them. Tool management and ToolsMCP allow secure, extensible tool invocation. The repo includes development instructions, contribution guidance, issue and bounty categories to onboard contributors, and examples of recommended mesh agents to accelerate real-world use and experimentation. An instant Heurist API key can be obtained using the code "agent" for developer access.

Please fill the required fields*