intentkit 0.8.24__tar.gz

intentkit-0.8.24/.gitignore

@@ -0,0 +1,178 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# MacOS
+.DS_Store
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+*.env
+.env
+!example.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# IDE
+.idea
+.vscode
+.cursor
+
+# web3
+wallet_data.txt
+
+# export/import data
+*.response
+scripts/*.yaml

intentkit-0.8.24/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Crestal Network
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

intentkit-0.8.24/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: intentkit
+Version: 0.8.24
+Summary: Intent-based AI Agent Platform - Core Package
+Project-URL: Homepage, https://github.com/crestalnetwork/intentkit
+Project-URL: Repository, https://github.com/crestalnetwork/intentkit
+Project-URL: Documentation, https://github.com/crestalnetwork/intentkit/tree/main/docs
+Project-URL: Bug Tracker, https://github.com/crestalnetwork/intentkit/issues
+Author-email: Ruihua <ruihua@crestal.network>
+License: MIT License
+        
+        Copyright (c) 2024 Crestal Network
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agent,ai,blockchain,crypto,intent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: ==3.13.*
+Requires-Dist: aiohttp>=3.11.16
+Requires-Dist: aiosqlite>=0.21.0
+Requires-Dist: asyncpg>=0.30.0
+Requires-Dist: aws-secretsmanager-caching>=1.1.3
+Requires-Dist: boto3<2.0.0,>=1.37.23
+Requires-Dist: botocore>=1.35.97
+Requires-Dist: cdp-sdk>=1.31.1
+Requires-Dist: coinbase-agentkit>=0.7.2
+Requires-Dist: cron-validator<2.0.0,>=1.0.8
+Requires-Dist: epyxid>=0.3.3
+Requires-Dist: eth-keys>=0.4.0
+Requires-Dist: eth-utils>=2.1.0
+Requires-Dist: fastapi>=0.115.8
+Requires-Dist: filetype<2.0.0,>=1.2.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: langchain-community>=0.3.19
+Requires-Dist: langchain-core>=0.3.43
+Requires-Dist: langchain-deepseek>=0.1.4
+Requires-Dist: langchain-mcp-adapters>=0.0.11
+Requires-Dist: langchain-openai>=0.3.8
+Requires-Dist: langchain-text-splitters>=0.3.8
+Requires-Dist: langchain-xai>=0.2.1
+Requires-Dist: langchain>=0.3.25
+Requires-Dist: langgraph-checkpoint-postgres>=2.0.16
+Requires-Dist: langgraph-checkpoint>=2.0.18
+Requires-Dist: langgraph-prebuilt>=0.6.1
+Requires-Dist: langgraph>=0.6.1
+Requires-Dist: langmem>=0.0.27
+Requires-Dist: mypy-boto3-s3<2.0.0,>=1.37.24
+Requires-Dist: openai>=1.59.6
+Requires-Dist: pillow<13.0.0,>=11.1.0
+Requires-Dist: psycopg-pool>=3.2.4
+Requires-Dist: psycopg>=3.2.9
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: pytz>=2025.1
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: redis<8.0.0,>=5.2.1
+Requires-Dist: requests-oauthlib>=2.0.0
+Requires-Dist: requests>=2.32.3
+Requires-Dist: slack-sdk>=3.34.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.37
+Requires-Dist: starlette>=0.47.1
+Requires-Dist: supabase>=2.16.0
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: tweepy[async]>=4.15.0
+Requires-Dist: uvicorn<1.0.0,>=0.34.0
+Requires-Dist: web3>=7.10.0
+Description-Content-Type: text/markdown
+
+# IntentKit
+
+IntentKit is a powerful intent-based AI agent platform that enables developers to build sophisticated AI agents with blockchain and cryptocurrency capabilities.
+
+## Features
+
+- **Intent-based Architecture**: Build agents that understand and execute user intents
+- **Blockchain Integration**: Native support for multiple blockchain networks
+- **Cryptocurrency Operations**: Built-in tools for DeFi, trading, and token operations
+- **Extensible Skills System**: Modular skill system with 30+ pre-built skills
+- **Multi-platform Support**: Telegram, Twitter, Slack, and API integrations
+- **Advanced AI Capabilities**: Powered by LangChain and LangGraph
+
+## Installation
+
+```bash
+pip install intentkit
+```
+
+## Development
+
+To build the package locally:
+
+```bash
+# Build both source and wheel distributions
+uv build
+
+# Build only wheel
+uv build --wheel
+
+# Build only source distribution
+uv build --sdist
+```
+
+To publish to PyPI:
+
+```bash
+# Build and publish to PyPI
+uv build
+uv publish
+
+# Publish to Test PyPI
+uv publish --publish-url https://test.pypi.org/legacy/
+```
+
+> **Note**: This package uses `hatchling` as the build backend with `uv` for dependency management and publishing.
+
+## Quick Start
+
+```python
+from intentkit.core.agent import Agent
+from intentkit.config.config import Config
+
+# Initialize configuration
+config = Config()
+
+# Create an agent
+agent = Agent(config=config)
+
+# Your agent is ready to use!
+```
+
+## Skills
+
+IntentKit comes with 30+ pre-built skills including:
+
+- **DeFi**: Uniswap, 1inch, Enso, LiFi
+- **Data**: DexScreener, CoinGecko, DefiLlama, CryptoCompare
+- **Social**: Twitter, Telegram, Slack
+- **Blockchain**: CDP, Moralis, various wallet integrations
+- **AI**: OpenAI, Heurist, Venice AI
+- **And many more...**
+
+## Documentation
+
+For detailed documentation, examples, and guides, visit our [documentation](https://github.com/crestal-network/intentkit/tree/main/docs).
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://github.com/crestal-network/intentkit/blob/main/CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+For support, please open an issue on our [GitHub repository](https://github.com/crestal-network/intentkit/issues).

intentkit-0.8.24/intentkit/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Crestal Network
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

intentkit-0.8.24/intentkit/MANIFEST.in

@@ -0,0 +1,14 @@
+include README.md
+include LICENSE
+recursive-include abstracts *.py
+recursive-include clients *.py
+recursive-include config *.py
+recursive-include core *.py
+recursive-include models *.py *.json
+recursive-include skills *.py *.toml *.md
+recursive-include utils *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.pyc
+recursive-exclude * *.pyo
+recursive-exclude * .DS_Store
+recursive-exclude * .ruff_cache

intentkit-0.8.24/intentkit/README.md

@@ -0,0 +1,88 @@
+# IntentKit
+
+IntentKit is a powerful intent-based AI agent platform that enables developers to build sophisticated AI agents with blockchain and cryptocurrency capabilities.
+
+## Features
+
+- **Intent-based Architecture**: Build agents that understand and execute user intents
+- **Blockchain Integration**: Native support for multiple blockchain networks
+- **Cryptocurrency Operations**: Built-in tools for DeFi, trading, and token operations
+- **Extensible Skills System**: Modular skill system with 30+ pre-built skills
+- **Multi-platform Support**: Telegram, Twitter, Slack, and API integrations
+- **Advanced AI Capabilities**: Powered by LangChain and LangGraph
+
+## Installation
+
+```bash
+pip install intentkit
+```
+
+## Development
+
+To build the package locally:
+
+```bash
+# Build both source and wheel distributions
+uv build
+
+# Build only wheel
+uv build --wheel
+
+# Build only source distribution
+uv build --sdist
+```
+
+To publish to PyPI:
+
+```bash
+# Build and publish to PyPI
+uv build
+uv publish
+
+# Publish to Test PyPI
+uv publish --publish-url https://test.pypi.org/legacy/
+```
+
+> **Note**: This package uses `hatchling` as the build backend with `uv` for dependency management and publishing.
+
+## Quick Start
+
+```python
+from intentkit.core.agent import Agent
+from intentkit.config.config import Config
+
+# Initialize configuration
+config = Config()
+
+# Create an agent
+agent = Agent(config=config)
+
+# Your agent is ready to use!
+```
+
+## Skills
+
+IntentKit comes with 30+ pre-built skills including:
+
+- **DeFi**: Uniswap, 1inch, Enso, LiFi
+- **Data**: DexScreener, CoinGecko, DefiLlama, CryptoCompare
+- **Social**: Twitter, Telegram, Slack
+- **Blockchain**: CDP, Moralis, various wallet integrations
+- **AI**: OpenAI, Heurist, Venice AI
+- **And many more...**
+
+## Documentation
+
+For detailed documentation, examples, and guides, visit our [documentation](https://github.com/crestal-network/intentkit/tree/main/docs).
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://github.com/crestal-network/intentkit/blob/main/CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+For support, please open an issue on our [GitHub repository](https://github.com/crestal-network/intentkit/issues).

intentkit-0.8.24/intentkit/__init__.py

@@ -0,0 +1,19 @@
+"""IntentKit - Intent-based AI Agent Platform.
+
+A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
+"""
+
+__version__ = "0.8.24"
+__author__ = "Ruihua"
+__email__ = "ruihua@crestal.network"
+
+# Core components
+# Abstract base classes
+from .core.engine import build_agent, create_agent, stream_agent, stream_agent_raw
+
+__all__ = [
+    "create_agent",
+    "stream_agent",
+    "build_agent",
+    "stream_agent_raw",
+]

intentkit-0.8.24/intentkit/abstracts/agent.py

@@ -0,0 +1,59 @@
+from abc import ABC, abstractmethod
+
+from intentkit.models.agent import Agent
+from intentkit.models.agent_data import AgentData, AgentQuota
+
+
+class AgentStoreABC(ABC):
+    """Abstract base class for agent data storage operations.
+
+    This class defines the interface for interacting with agent-related data,
+    including configuration, additional data, and quotas.
+
+    Attributes:
+        agent_id: ID of the agent to store/retrieve data for
+    """
+
+    def __init__(self, agent_id: str) -> None:
+        """Initialize the agent store.
+
+        Args:
+            agent_id: ID of the agent
+        """
+        self.agent_id = agent_id
+
+    @abstractmethod
+    async def get_config(self) -> Agent | None:
+        """Get agent configuration.
+
+        Returns:
+            Agent configuration if found, None otherwise
+        """
+        pass
+
+    @abstractmethod
+    async def get_data(self) -> AgentData | None:
+        """Get additional agent data.
+
+        Returns:
+            Agent data if found, None otherwise
+        """
+        pass
+
+    @abstractmethod
+    async def set_data(self, data: dict) -> None:
+        """Update agent data.
+
+        Args:
+            data: Dictionary containing fields to update
+        """
+        pass
+
+    @abstractmethod
+    async def get_quota(self) -> AgentQuota | None:
+        """Get agent quota information.
+
+        Returns:
+            Agent quota if found, None otherwise
+        """
+        pass

intentkit-0.8.24/intentkit/abstracts/api.py

@@ -0,0 +1,4 @@
+ResponseHeadersPagination = {
+    "X-Next-Cursor": {"description": "Cursor for next page"},
+    "X-Has-More": {"description": "Indicates if there are more items"},
+}

intentkit-0.8.24/intentkit/abstracts/engine.py

@@ -0,0 +1,38 @@
+from collections.abc import Callable
+
+from pydantic import BaseModel
+
+
+class AgentMessageInput(BaseModel):
+    """Input message model for AI agent interactions.
+
+    This class represents the structured input that can be sent to an AI agent,
+    supporting both text-based queries and image-based inputs for multimodal
+    interactions.
+
+    Attributes:
+        text (str): The main text content of the message or query
+        images (list[str]): List of image references/URLs to be processed by the agent.
+                           Empty list if no images are provided.
+    """
+
+    text: str  # required
+    """The main text content or query to be processed by the agent"""
+
+    images: list[str] = []  # optional, defaults to empty list
+    """List of image references or URLs for multimodal processing"""
+
+
+# Define a type hint for the callback that takes three strings and returns a list of strings
+AgentExecutionCallback = Callable[[str, AgentMessageInput, str], list[str]]
+"""Callback function type for agent execution.
+
+Args:
+    aid (str): The agent ID that uniquely identifies the AI agent
+    message (AgentMessageInput): The input message containing text and optional images
+    thread_id (str): The thread ID for tracking the conversation context
+
+Returns:
+    list[str]: A list of formatted response lines from the agent execution. Each line
+        typically contains input/output markers, agent responses, and timing information.
+"""

intentkit-0.8.24/intentkit/abstracts/graph.py

@@ -0,0 +1,48 @@
+from collections.abc import Callable
+from enum import Enum
+from typing import Any, NotRequired
+
+from langgraph.prebuilt.chat_agent_executor import AgentState as BaseAgentState
+from pydantic import BaseModel
+
+from intentkit.models.agent import Agent
+from intentkit.models.chat import AuthorType
+
+
+class AgentError(str, Enum):
+    """The error types that can be raised by the agent."""
+
+    INSUFFICIENT_CREDITS = "insufficient_credits"
+
+
+# We create the AgentState that we will pass around
+# This simply involves a list of messages
+# We want steps to return messages to append to the list
+# So we annotate the messages attribute with operator.add
+class AgentState(BaseAgentState):
+    """The state of the agent."""
+
+    context: dict[str, Any]
+    error: NotRequired[AgentError]
+    __extra__: NotRequired[dict[str, Any]]
+
+
+class AgentContext(BaseModel):
+    agent_id: str
+    get_agent: Callable[[], Agent]
+    chat_id: str
+    user_id: str | None = None
+    app_id: str | None = None
+    entrypoint: AuthorType
+    is_private: bool
+    search: bool = False
+    thinking: bool = False
+    payer: str | None = None
+
+    @property
+    def agent(self) -> Agent:
+        return self.get_agent()
+
+    @property
+    def thread_id(self) -> str:
+        return f"{self.agent_id}-{self.chat_id}"