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.
We just migrated to uv from poetry.
You need to delete the .venv folder and run uv sync
to create a new virtual environment. (one time)
rm -rf .venv
uv sync
- 🤖 Multiple Agent Support
- 🔄 Autonomous Agent Management
- 🔗 Blockchain Integration (EVM chains first)
- 🐦 Social Media Integration (Twitter, Telegram, and more)
- 🛠️ Extensible Skill System
- 🔌 MCP (WIP)
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.
Read Development Guide to get started with your setup.
Check out Documentation before you start.
The project is divided into the core package and the application:
-
intentkit/: The IntentKit package (published as a pip package)
- abstracts/: Abstract classes and interfaces for core and skills
- clients/: Clients for external services
- config/: System level configurations
- core/: Core agent system, driven by LangGraph
- models/: Entity models using Pydantic and SQLAlchemy
- skills/: Extensible skills system, based on LangChain tools
- utils/: Utility functions
-
app/: The IntentKit app (API server, autonomous runner, and background scheduler)
- admin/: Admin APIs, agent generators, and related functionality
- entrypoints/: Entrypoints for interacting with agents (web, Telegram, Twitter, etc.)
- services/: Service implementations for Telegram, Twitter, etc.
- api.py: REST API server
- autonomous.py: Autonomous agent runner
- checker.py: Health and credit checking logic
- readonly.py: Readonly entrypoint
- scheduler.py: Background task scheduler
- singleton.py: Singleton agent manager
- telegram.py: Telegram integration
- twitter.py: Twitter integration
-
docs/: Documentation
-
scripts/: Operation and temporary scripts for management and migrations
Contributions are welcome! Please read our Contributing Guidelines before submitting a pull request.
First check Wishlist for active requests.
Once you are ready to start, see Skill Development Guide for more information.
Join our Discord, open a support ticket to apply for an intentkit dev role.
We have a discussion channel there for you to join up with the rest of the developers.
This project is licensed under the MIT License - see the LICENSE file for details.