crestalnetwork/intentkit

IntentKit

IntentKit is an autonomous agent framework that enables the creation and management of AI agents with various capabilities including blockchain interaction, social media management, and custom skill integration.

Alpha Warning

This project is currently in alpha stage and is not recommended for production use.

Features

🤖 Multiple Agent Support
🔄 Autonomous Agent Management
🔗 Blockchain Integration (EVM chains first)
🐦 Social Media Integration (Twitter, Telegram, and more)
🛠️ Extensible Skill System
🔌 Extensible Plugin System (WIP)

Architecture

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


                                                                                    
                                 Entrypoints                                        
                       │                             │                              
                       │   Twitter/Telegram & more   │                              
                       └──────────────┬──────────────┘                              
                                      │                                             
  Storage:  ────┐                     │                      ┌──── Skills:          
                │                     │                      │                      
  Agent Config  │     ┌───────────────▼────────────────┐     │  Chain Integration   
                │     │                                │     │                      
  Credentials   │     │                                │     │  Wallet Management   
                │     │           The Agent            │     │                      
  Personality   │     │                                │     │  On-Chain Actions    
                │     │                                │     │                      
  Memory        │     │      Powered by LangGraph      │     │  Internet Search     
                │     │                                │     │                      
  Skill State   │     └────────────────────────────────┘     │  Image Processing    
            ────┘                                            └────                  
                                                                                    
                                                                More and More...    
                         ┌──────────────────────────┐                               
                         │                          │                               
                         │  Agent Config & Memory   │                               
                         │                          │                               
                         └──────────────────────────┘                               
                                                                                    

The architecture is a simplified view, and more details can be found in the Architecture section.

Development

Read Development Guide to get started with your setup.

Documentation

Check out Documentation before you start.

Project Structure

abstracts/: Abstract classes and interfaces
app/: Core application code
- core/: Core modules
- services/: Services
- entrypoints/: Entrypoints means the way to interact with the agent
- admin/: Admin logic
- config/: Configurations
- api.py: REST API server
- autonomous.py: Autonomous agent scheduler
- singleton.py: Singleton agent scheduler
- scheduler.py: Scheduler for periodic tasks
- readonly.py: Readonly entrypoint
- twitter.py: Twitter listener
- telegram.py: Telegram listener
clients/: Clients for external services
docs/: Documentation
models/: Database models
scripts/: Scripts for agent management
skills/: Skill implementations
plugins/: Reserved for Plugin implementations
utils/: Utility functions

Contributing

Contributions are welcome! Please read our Contributing Guidelines before submitting a pull request.

Contribute Skills

First check Wishlist for active requests.

Once you are ready to start, see Skill Development Guide for more information.

License

This project is licensed under the MIT License - see the LICENSE file for details.