Brain Framework
Brain Framework is a developer toolkit designed for building AI agents, emphasizing flexibility and type safety through a TypeScript-first approach. Developed by IQ AI [1], it provides a programmatic way to configure and develop agents, offering an alternative to configuration file-based methods like those used in systems such as ElizaOS [2]. The framework is particularly oriented towards creating AI agents with on-chain capabilities, including integrations for decentralized finance (DeFi) operations [3] [1].
Overview
The Brain Framework was developed by IQ AI [1] to address the need for more programmatic control and type safety in AI agent development, contrasting with approaches that rely heavily on configuration files like character.json
used in systems such as ElizaOS [2]. By adopting a TypeScript-first methodology, the framework allows developers to define agent configurations directly in code, leveraging the benefits of static typing, including improved tooling, refactoring capabilities, and reduced runtime errors [2].
The framework utilizes a builder pattern for setting up and configuring agents, aiming for an intuitive developer experience [2]. It is designed to be compatible with existing plugins from related agent development ecosystems while also offering its own set of specialized core plugins and an extended plugin system with enhanced utilities [2] [4]. The project is under active development, with frequent updates and new features being introduced [3].
Key Features
Brain Framework incorporates several features aimed at enhancing the development of AI agents:
- Type-Safe Configuration: Agent configurations are defined in code using TypeScript, providing type checking and eliminating the need for external, untyped configuration files [2].
- Builder Pattern: An intuitive API allows developers to construct and configure agents programmatically [2].
- Core Plugins: Includes specialized plugins for common agent tasks:
- Heartbeat: Provides a simplified implementation for scheduling cron jobs to automate agent operations [2] [3] [5].
- Sequencer: Enables chaining multiple actions or plugin calls from a single user query [2] [3] [6].
- ATP Integration: Designed for integration with the IQAI Agent Tokenization Platform (ATP) for tokenizing agents [2] [7].
- Extended Plugin System: Offers an improved system for creating custom plugins with additional utilities and helpers [2].
Core Concepts
The framework is built around several core concepts:
- Agent: The central component, configured programmatically using an
AgentBuilder
for type-safe setup and flexible options [2]. - Clients: Type-safe interfaces for communication with various platforms, such as messaging applications or social media, featuring improved error handling [2].
- Plugins: Modular components that extend agent capabilities, including specialized plugins for DeFi operations, scheduling, and other functions [2] [8]. The framework's plugin system is designed for flexibility and on-chain composability, allowing developers to connect agents to specialized functions like DeFi operations, token swaps, or other blockchain interactions [4].
- Model Providers: Structured integrations for connecting with various AI models (e.g., OpenAI, Claude), maintaining type safety throughout the interaction [2].
Technology
Brain Framework is primarily developed using TypeScript, accounting for approximately 79.5% of the codebase [9]. The framework promotes a TypeScript-first approach, utilizing code-based configuration and a builder pattern for agent development [2]. Other languages present in the repository include MDX (for documentation), JavaScript, CSS, Astro, Shell, and HTML [9]. The project is licensed under the MIT License [9].
Plugins
The framework features a rich plugin system that allows agents to interact with external services and perform specific tasks. This includes a focus on integrations relevant to decentralized finance (DeFi) [3] [4]. The Brain framework continued to expand its modular plugins to support building agents capable of trading, lending, borrowing, and more [4]. Examples of available plugins include:
- ABI: Interact with any EVM-compatible smart contract by generating actions from the contract’s Application Binary Interface (ABI) [10] [4].
- Near: Integration with the NEAR Protocol blockchain, enabling smart contract interactions, transaction handling, and event listening capabilities [11] [4].
- Fraxlend: Enable lending/borrowing on Fraxtal [12] [4].
- Odos: Perform optimized token swaps [13] [4].
- Wiki: Retrieve blockchain knowledge from IQ.Wiki [14].
- ATP: Interact with IQ's Agent Tokenization Platform [7] [4].
- BAMM: Access Frax BAMM lending and borrowing pools [15] [4].
- Heartbeat: Schedule automated posts or messages across platforms [5] [4].
- Sequencer: Chain multiple actions from one query with memory [6] [4].
- Bootstrap [16].
- Images [17].
- Node [18].
- Solana [19].
- MCP: Connect agents to external MCP servers [20] [4].
- Wallet: Access wallet data and transaction history across chains [21] [4].
The system is designed to be extensible, allowing developers to create custom plugins with enhanced utilities [2]. Additionally, the ElizaOS Plugin library offers a growing collection of community-built tools, covering interfaces, data storage, and integrations, which are fully compatible with Brain Framework agents [4].
Clients
Brain Framework provides type-safe communication interfaces, referred to as clients, to connect agents with various platforms. These clients facilitate interactions between the AI agent and users on different services [2]. Examples of supported clients include:
Use Cases
The primary use case for Brain Framework is the development of intelligent AI agents, particularly those requiring on-chain capabilities and interaction with decentralized finance protocols [3] [1]. The framework's design supports automated tasks through features like the Heartbeat plugin for scheduling and the Sequencer plugin for chaining actions [3]. It is also presented as the recommended framework for developers planning to tokenize their agents via the IQAI ATP platform, offering seamless integration with that ecosystem [2] [1].
ATP is a DeFAI (Decentralized Finance + AI) platform that enables the creation of tokenized AI agents capable of autonomously managing assets, executing financial strategies, and interacting with decentralized economies [1]. Brain Framework is used to deploy these agents with modular DeFi plugins [1]. Examples of agents launched on ATP using the Brain framework include SOPHIA, the AI Editor of IQ.wiki and the first ATP agent [4], and AIDEN, which is becoming tokenized [4]. Other agents launched on ATP include Detective Cipher (focusing on tracking transactions, uncovering scams, and ensuring privacy), DK the DeFi Trader (capitalizing on price gaps), and IK the Liquid IQ AI Rapper (using staking rewards for buy-and-burn) [4]. Luna the Bitcoin Witch, designed to accumulate WBTC through DeFi strategies, was also launched on ATP [4].
ATP agents are sovereign entities with built-in wallets, tokenized ownership, and autonomy, enabling them to actively participate in the blockchain economy [1]. Each agent owns 8% of its token supply at launch, allowing it to manage assets and interact with DeFi protocols [1]. Governed by token holders, these agents operate independently within decentralized ecosystems [1].
Beyond DeFi, ATP extends to enabling AI Agents to interact with the physical world, such as controlling autonomous robotics and optimizing IoT automation for logistics, supply chains, and smart infrastructure [1].
The IQ Token and ATP
The IQ token is central to the ATP ecosystem, driving governance, utility, and growth [1]. All ATP fees are paid in IQ, every tokenized agent has an IQ pair, and IQ serves as the governance token [1]. Staking IQ tokens with HiIQ allows participation in governance decisions and earning staking rewards [1]. The IQ token saw significant growth in April 2025, with a trading volume over $250 million on April 17th and a 54% increase over 24 hours, according to CoinMarketCap data [4]. This growth strengthened the BrainDAO treasury, which held over $30 million in total assets as of April 2025 [4].
Partnerships
ATP has established strategic partnerships to enhance its platform and reach:
- Fraxtal: ATP will launch on Fraxtal, leveraging its advanced DeFi infrastructure. Frax will also use ATP to launch FraxAI, its first tokenized agent [1]. Initial deployment will focus on cross-chain execution, and ATP is designed for broad adoption, allowing blockchain projects to deploy and train tokenized AI agents for their ecosystems [1].
- NEAR: ATP is set to integrate with NEAR, unlocking advanced AI infrastructure and cross-chain capabilities. This integration will leverage NEAR's purpose-built AI development stack and cross-chain architecture for enhanced scalability and interoperability [1].
IQ AI Ecosystem
Even before ATP's launch, IQ AI powers applications that simplify blockchain knowledge and engagement [1].
- AIDEN: Trusted by over 2 million users, AIDEN is an AI agent providing blockchain insights across 100+ crypto communities [1]. AIDEN has been integrated into over 100 protocols' Telegram and Discord groups, with projects like Frax Finance customizing the bot [4]. Recent integrations in April 2025 included DDAI, DeCenter AI, DeTrip, Lunos DAO, and DonutSwap [4]. AIDEN is becoming tokenized, with a new $AIDEN token planned to govern the agent directly [4].
- IQ.wiki: The largest blockchain encyclopedia, making crypto knowledge accessible [1]. In April 2025, IQ.wiki onboarded projects including ZKCrypt AI, ShillGuard, and PumpSpace [4].
ATP Points
ATP Points incentivize engagement with the Agent Tokenization Platform [1]. Users can earn points by holding IQ tokens on Fraxtal, providing liquidity to IQ-agent pairs, holding tokenized AI agents, and engaging in the Kaito IQ Yappers leaderboard [1] [4]. ATP Points are planned to convert into IQ tokens or a dedicated ATP token, with IQ stakers deciding after one year [1].
Development and Community
Brain Framework is positioned as a developer-first toolkit, emphasizing ease of use and robust tooling for developers [3]. Comprehensive documentation is available online, covering tutorials, API references, and best practices [9]. New guides were released in April 2025 covering how to launch your own agent, purchase agent tokens, and navigate the agent graduation process [4]. An Agent Generator tool was also introduced to simplify agent creation [4].
The project's development is managed on GitHub [9]. The community engages through GitHub Discussions for questions, idea sharing, and showcasing projects [9]. Contributions to the framework are welcomed, with guidelines provided for potential contributors [9]. The repository also maintains a list of issues suitable for beginners looking to contribute [9]. As of June 2025, the repository had 21 stars and 5 forks, with 9 listed contributors [9].