base on 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! # IntentKit <div align="center"> <img src="docs/images/intentkit_banner.png" alt="IntentKit by Crestal" width="100%" /> </div> <br> 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. ", Assign "at most 3 tags" to the expected json: {"id":"13430","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"