An agent framework that speaks crypto natively
It wires multi-platform AI agents to a marketplace of crypto-native skills so generalist models stop guessing at tokenomics.

What it does
Heurist Agent Framework is a Python toolkit for building AI agents that chat across Telegram, Discord, Twitter, Farcaster, or a plain REST API. It bundles voice and image generation, vector memory backed by PostgreSQL or SQLite, and a modular core that juggles personalities, knowledge retrieval, and conversation state. The framework also taps into Heurist Mesh, a collection of 30-plus specialized agents tuned for crypto analytics, on-chain forensics, and DeFi data.
The interesting bit
Most agent frameworks give you plumbing; Heurist layers a Web3 skills marketplace on top. Mesh agents are reachable via REST, MCP, or an x402 pay-per-use flow in USDC on Base, and their MCP endpoints are registered under the ERC-8004 trusted-agent standard on Ethereum. That is a lot of blockchain ceremony for an AI toolkit, but it means your agent can query token prices or wallet behavior without pretending to understand Solidity.
Key highlights
- Modular core with swappable components:
PersonalityProvider,KnowledgeProvider,LLMProvider, andMediaHandler. - Built-in workflows for RAG, chain-of-thought reasoning, and deep web research.
- The README claims Mesh integration cuts tool calls by 70% and token usage by 30–50% compared with simple API wrappers.
- Multi-platform interfaces out of the box: Telegram, Discord, Twitter, Farcaster, Flask-based REST API, and MCP.
- Pay-per-use access to Mesh agents via x402 on Base, plus standard REST API keys.
Caveats
- The README lists voice, image, and video capabilities but offers no examples or quality benchmarks, so maturity is unclear.
- Licensed under BSL 1.1, which is source-available but carries commercial use restrictions until conversion.
- The framework is tightly coupled to the Heurist ecosystem; running Mesh agents requires Heurist API keys and infrastructure.
Verdict
Worth a spin if you want a crypto-savvy assistant without building the data layer yourself. Look elsewhere if you need a fully open-source stack or have no use for blockchains.
Frequently asked
- What is heurist-network/heurist-agent-framework?
- It wires multi-platform AI agents to a marketplace of crypto-native skills so generalist models stop guessing at tokenomics.
- Is heurist-agent-framework open source?
- Yes — heurist-network/heurist-agent-framework is an open-source project tracked on heatdrop.
- What language is heurist-agent-framework written in?
- heurist-network/heurist-agent-framework is primarily written in Python.
- How popular is heurist-agent-framework?
- heurist-network/heurist-agent-framework has 818 stars on GitHub.
- Where can I find heurist-agent-framework?
- heurist-network/heurist-agent-framework is on GitHub at https://github.com/heurist-network/heurist-agent-framework.