https://github.com/crestalnetwork/intentkit
An open and fair framework for everyone to build AI agents equipped with powerful skills. Launch your agent, improve the world, your wallet, or both!
https://github.com/crestalnetwork/intentkit
agentic-workflow ai ai-agent ai-agent-framework blockchain intents launchpad python web3
Last synced: about 9 hours ago
JSON representation
An open and fair framework for everyone to build AI agents equipped with powerful skills. Launch your agent, improve the world, your wallet, or both!
- Host: GitHub
- URL: https://github.com/crestalnetwork/intentkit
- Owner: crestalnetwork
- License: mit
- Created: 2024-12-09T04:32:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-12T11:34:43.000Z (4 days ago)
- Last Synced: 2026-01-12T15:36:58.957Z (4 days ago)
- Topics: agentic-workflow, ai, ai-agent, ai-agent-framework, blockchain, intents, launchpad, python, web3
- Language: Python
- Homepage: https://x.com/intentkitai
- Size: 9.15 MB
- Stars: 6,480
- Watchers: 71
- Forks: 697
- Open Issues: 68
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
- StarryDivineSky - crestalnetwork/intentkit
- awesome-agent-skills - IntentKit - Framework for intent-driven AI agents (🏗️ Phase 3: Build & Integrate / 🔧 Developer Tools)
- AiTreasureBox - crestalnetwork/intentkit - 11-03_6449_0](https://img.shields.io/github/stars/crestalnetwork/intentkit.svg)|An open and fair framework for everyone to build AI agents equipped with powerful skills. Launch your agent, improve the world, your wallet, or both!| (Repos)
- awesome-ai-agents - crestalnetwork/intentkit - IntentKit is an open-source autonomous agent framework that enables the creation and management of AI agents with blockchain and social media integrations, featuring an extensible skill and plugin system. (Agent Integration & Deployment Tools / AI Application Development)
- awesome-web3-ai - IntentKit
README
# 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.
## Package Manager Migration Warning
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)
```bash
rm -rf .venv
uv sync
```
## Features
- 🤖 Multiple Agent Support
- 🔄 Autonomous Agent Management
- 🔗 Blockchain Integration (EVM chains first)
- 🐦 Social Media Integration (Twitter, Telegram, and more)
- 🛠️ Extensible Skill System
- 🔌 MCP (WIP)
## Architecture
```
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](docs/architecture.md) section.
## Development
Read [Development Guide](DEVELOPMENT.md) to get started with your setup.
## Documentation
Check out [Documentation](docs/) before you start.
## Project Structure
The project is divided into the core package and the application:
- **[intentkit/](intentkit/)**: The IntentKit package (published as a pip package)
- [abstracts/](intentkit/abstracts/): Abstract classes and interfaces for core and skills
- [clients/](intentkit/clients/): Clients for external services
- [config/](intentkit/config/): System level configurations
- [core/](intentkit/core/): Core agent system, driven by LangGraph
- [models/](intentkit/models/): Entity models using Pydantic and SQLAlchemy
- [skills/](intentkit/skills/): Extensible skills system, based on LangChain tools
- [utils/](intentkit/utils/): Utility functions
- **[app/](app/)**: The IntentKit app (API server, autonomous runner, and background scheduler)
- [admin/](app/admin/): Admin APIs, agent generators, and related functionality
- [entrypoints/](app/entrypoints/): Entrypoints for interacting with agents (web, Telegram, Twitter, etc.)
- [services/](app/services/): Service implementations for Telegram, Twitter, etc.
- [api.py](app/api.py): REST API server
- [autonomous.py](app/autonomous.py): Autonomous agent runner
- [checker.py](app/checker.py): Health and credit checking logic
- [readonly.py](app/readonly.py): Readonly entrypoint
- [scheduler.py](app/scheduler.py): Background task scheduler
- [telegram.py](app/telegram.py): Telegram integration
- [twitter.py](app/twitter.py): Twitter integration
- [docs/](docs/): Documentation
- [scripts/](scripts/): Operation and temporary scripts for management and migrations
## Agent API
IntentKit provides a comprehensive REST API for programmatic access to your agents. Build applications, integrate with existing systems, or create custom interfaces using our Agent API.
**Get Started:** [Agent API Documentation](docs/agent_api.md)
## Contributing
Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting a pull request.
### Contribute Skills
First check [Wishlist](docs/contributing/wishlist.md) for active requests.
Once you are ready to start, see [Skill Development Guide](docs/contributing/skills.md) for more information.
### Developer Chat
Join our [Discord](https://discord.com/invite/crestal), 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.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.