# IntentKit

<div align="center">
    <img src="frontend/src/app/icon.svg" alt="IntentKit" width="20%" height="20%"/>
</div>
<div align="center">
    <h3>Your Cloud-Native Agent Team</h3>
</div>
<div align="center">
  <a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/pypi/l/intentkit" alt="PyPI - License"></a>
  <a href="https://pypi.org/project/intentkit/#history" target="_blank"><img src="https://img.shields.io/pypi/v/intentkit" alt="PyPI Version"></a>
  <a href="https://hub.docker.com/r/crestal/intentkit" target="_blank"><img src="https://img.shields.io/docker/v/crestal/intentkit?label=Docker" alt="Docker"></a>
  <a href="https://intentcat.com/docs" target="_blank"><img src="https://img.shields.io/badge/docs-intentcat.com-blue" alt="Documentation"></a>
</div>

IntentKit is an open-source, self-hosted cloud agent cluster that manages a collaborative team of AI agents for you.

## Why IntentKit

Current AI agents generally follow two paths:

1. **Local-First** (e.g., OpenClaw): These serve as personal assistants or experimental tools. However, they often require expensive hardware and extensive local permissions.
2. **Cloud-Native**: Similar to modern web apps, these run in the cloud, consume minimal local resources, require zero maintenance, and offer high reliability for completing tasks.

If you are looking for a robust, cloud-native solution, IntentKit is for you.

## Features

- ☁️ **Cloud-Native:** Ultimate resource efficiency.
- 🔒 **Secure by Design:** Agents are fundamentally unable to access any of your secret keys.
- 🤖 **Collaborative AI:** Multiple agents that can call and interact with each other.
- 🔄 **Out-of-the-Box Ready:** Fully configured and ready to use.
- 🔗 **Crypto-Friendly:** Optional Web3 and blockchain integrations.
- 🐦 **Social Media Integration:** Seamlessly connects with social platforms.
- 🛠️ **Extensible Skill System:** Easily add new capabilities.

## Documentation

Please check out the [Documentation](https://intentcat.com/docs/) before getting started.

## Deployment

Read the [Deployment Guide](https://intentcat.com/docs/deployment/) to get started with your setup.

## Other Use Cases

Besides self-deploying IntentKit, you can also use the project in the following ways:

- **As a Python Library:** Import and extend IntentKit, or use it to add agent cluster capabilities to your existing projects.
- **Via API:** Regardless of the deployment method, you can interact with agents from external applications via the built-in API endpoints.

## Contributing

Due to the rapid pace of AI development, we currently do not accept code contributions via Pull Requests. However, submitting feature requests and reporting bugs in the GitHub Issues section is highly appreciated and the best way to contribute.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
