Name | sakit JSON |
Version |
12.4.11
JSON |
| download |
home_page | None |
Summary | Solana Agent Kit |
upload_time | 2025-07-26 01:31:58 |
maintainer | None |
docs_url | None |
author | Bevan Hunt |
requires_python | <4.0,>=3.12 |
license | MIT |
keywords |
ai
openai
ai agents
agi
|
VCS |
 |
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# Solana Agent Kit
[](https://pypi.org/project/sakit)
[](https://www.python.org/downloads/)
[](https://pypi.org/project/sakit/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/astral-sh/ruff)
[](https://libraries.io/pypi/sakit)
A collection of powerful plugins to extend the capabilities of Solana Agent.
## 🚀 Features
Solana Agent Kit provides a growing library of plugins that enhance your Solana Agent with new capabilities:
* Solana Transfer - Transfer Solana tokens between the agent's wallet and the destination wallet
* Solana Swap - Swap Solana tokens on Jupiter in the agent's wallet
* Solana Balance - Get the token balances of a wallet
* Solana Price - Get the price of a token
* Solana SNS Lookup - Get the Solana address for a SNS domain
* Rugcheck - Check if a token is a rug
* Internet Search - Search the internet in real-time using Perplexity, Grok, or OpenAI
* MCP - Interface with any MCP web server - Zapier is supported
* Image Generation - Generate images with OpenAI, Grok, or Gemini with uploading to S3 compatible storage
* Nemo Agent - Generate Python projects with Nemo Agent with uploading to S3 compatible storage
## 📦 Installation
```bash
pip install sakit
```
## 🔌 Plugins
### Solana Transfer
This plugin enables Solana Agent to transfer SOL and SPL tokens from the agent's wallet to the destination wallet.
Don't use tickers - but mint addresses in your user queries.
```python
config = {
"tools": {
"solana_transfer": {
"rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
"private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
},
},
}
```
### Solana Swap
This plugin enables Solana Agent to swap tokens using Jupiter.
Don't use tickers - but mint addresses in your user queries.
```python
config = {
"tools": {
"solana_swap": {
"rpc_url": "my-rpc-url", # Required - your RPC URL - Helius is recommended
"private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
"jupiter_url": "my-custom-url" # Optional - if you are using a custom Jupiter service like Metis from QuickNode
},
},
}
```
### Solana Balance
This plugin enables Solana Agent to get the token balances of a wallet.
```python
config = {
"tools": {
"solana_balance": {
"api_key": "my-alphavybe-api-key", # Required - your AlphaVybe API key - the free plan allows this call
},
},
}
```
### Solana Price
This plugin enables Solana Agent to get the price in USD of a token.
```python
config = {
"tools": {
"solana_price": {
"api_key": "my-birdeye-api-key", # Required - your Birdeye API key - the free plan allows this call
},
},
}
```
### Solana SNS Lookup
This plugin enables Solana Agent to get the Solana address of an SNS domain.
```python
config = {
"tools": {
"sns_lookup": {
"quicknode_url": "my-quicknode-rpc-url", # Required - your QuickNode RPC URL with the SNS addon enabled
},
},
}
```
### Rugcheck
This plugin enables Solana Agent to check if a token is a rug.
No config is needed.
### Internet Search
This plugin enables Solana Agent to search the internet for up-to-date information using Perplexity or OpenAI.
Please ensure you include a prompt to instruct the agent to use the tool - otherwise it may not use it.
```python
config = {
"tools": {
"search_internet": {
"api_key": "your-api-key", # Required - either a Perplexity, Grok, or OpenAI API key
"provider": "openai", # Optional, defaults to openai - can be "openai', "perplexity", or "grok" - grok also searches X
"citations": True, # Optional, defaults to True - only applies for Perplexity and Grok
"model": "gpt-4o-mini-search-preview" # Optional, defaults to "sonar" for Perplexity or "gpt-4o-mini-search-preview" for OpenAI or "grok-3-mini-fast" for Grok
}
},
"agents": [
{
"name": "research_specialist",
"instructions": "You are an expert researcher who synthesizes complex information clearly. You use your search_internet tool to get the latest information.",
"specialization": "Research and knowledge synthesis",
"tools": ["search_internet"], # Enable the tool for this agent
}
]
}
```
**Available Search Models for Perplexity**
* sonar
* sonar-pro
**Available Search Models for OpenAI**
* gpt-4o-mini-search-preview
* gpt-4o-search-preview
**Available Search Models for Grok**
* grok-3
* grok-3-fast
* grok-3-mini
* grok-3-mini-fast
### MCP
[Zapier](https://zapier.com/mcp) MCP has been tested, works, and is supported.
Zapier integrates over 7,000+ apps with 30,000+ actions that your AI Agent can utilize.
Other MCP servers may work but are not supported.
OpenAI is a requirement.
```python
config = {
"openai": {
"api_key": "your-api-key",
},
"tools": {
"mcp": {
"url": "my-zapier-mcp-url",
}
},
"agents": [
{
"name": "zapier_expert",
"instructions": "You are an expert in using Zapier integrations using MCP. You always use the mcp tool to perform Zapier AI like actions.",
"specialization": "Zapier service integration expert",
"tools": ["mcp"], # Enable the tool for this agent
}
]
}
```
### Image Generation
This plugin allows the agent to generate images using OpenAI's `gpt-image-1` model or Grok's `grok-2-image` and upload them to S3-compatible storage. It returns the public URL of the uploaded image.
This has been tested using [Cloudflare R2](https://developers.cloudflare.com/r2/).
```python
config = {
"tools": {
"image_gen": {
"provider": "openai", # Required: either "openai", "grok", or "gemini"
"api_key": "your-api-key", # Required: your OpenAI or Grok or Gemini API key
"s3_endpoint_url": "https://your-s3-endpoint.com", # Required: e.g., https://nyc3.digitaloceanspaces.com
"s3_access_key_id": "YOUR_S3_ACCESS_KEY", # Required: Your S3 access key ID
"s3_secret_access_key": "YOUR_S3_SECRET_KEY", # Required: Your S3 secret access key
"s3_bucket_name": "your-bucket-name", # Required: The name of your S3 bucket
"s3_region_name": "your-region", # Optional: e.g., "nyc3", needed by some providers
"s3_public_url_base": "https://your-cdn-or-bucket-url.com/", # Optional: Custom base URL for public links (include trailing slash). If omitted, a standard URL is constructed.
}
},
"agents": [
{
"name": "image_creator",
"instructions": "You are a creative assistant that generates images based on user descriptions. Use the image_gen tool to create and store the image.",
"specialization": "Image generation and storage",
"tools": ["image_gen"], # Enable the tool for this agent
}
]
}
```
**Image Models Used:**
* OpenAI - `gpt-image-1`
* Grok - `grok-2-image`
* Gemini - `imagen-3.0-generate-002`
### Nemo Agent
This plugin allows the agent to generate python programs using [Nemo Agent](https://nemo-agent.com) and uploads the files in a ZIP file to s3-compatible storage. It returns the public URL of the zip file.
This has been tested using [Cloudflare R2](https://developers.cloudflare.com/r2/).
```python
config = {
"tools": {
"nemo_agent": {
"provider": "openai", # Required: either "openai" or "gemini"
"api_key": "your-api-key", # Required: your OpenAI or Gemini API key
"s3_endpoint_url": "https://your-s3-endpoint.com", # Required: e.g., https://nyc3.digitaloceanspaces.com
"s3_access_key_id": "YOUR_S3_ACCESS_KEY", # Required: Your S3 access key ID
"s3_secret_access_key": "YOUR_S3_SECRET_KEY", # Required: Your S3 secret access key
"s3_bucket_name": "your-bucket-name", # Required: The name of your S3 bucket
"s3_region_name": "your-region", # Optional: e.g., "nyc3", needed by some providers
"s3_public_url_base": "https://your-cdn-or-bucket-url.com/", # Optional: Custom base URL for public links (include trailing slash). If omitted, a standard URL is constructed.
}
},
"agents": [
{
"name": "python_dev",
"instructions": "You are an expert Python Developer. You always use your nemo_agent tool to generate python code.",
"specialization": "Python Developer",
"tools": ["nemo_agent"], # Enable the tool for this agent
}
]
}
```
## 🧩 Plugin Development
Want to add your own plugins to Solana Agent Kit? Follow these guidelines:
1. Create a new plugin directory under solana_agent_kit/
2. Implement a plugin class that follows Solana Agent's plugin architecture
3. Add your plugin to the list in __init__.py
4. Test thoroughly
5. Submit a PR!
## 📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "sakit",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.12",
"maintainer_email": null,
"keywords": "ai, openai, ai agents, agi",
"author": "Bevan Hunt",
"author_email": "bevan@bevanhunt.com",
"download_url": "https://files.pythonhosted.org/packages/b1/db/4b110d1cc693ee2ac8377c2c53b5787130a00448b5313de91a8a0a664384/sakit-12.4.11.tar.gz",
"platform": null,
"description": "# Solana Agent Kit\n\n[](https://pypi.org/project/sakit)\n[](https://www.python.org/downloads/)\n[](https://pypi.org/project/sakit/)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/astral-sh/ruff)\n[](https://libraries.io/pypi/sakit)\n\nA collection of powerful plugins to extend the capabilities of Solana Agent.\n\n## \ud83d\ude80 Features\nSolana Agent Kit provides a growing library of plugins that enhance your Solana Agent with new capabilities:\n\n* Solana Transfer - Transfer Solana tokens between the agent's wallet and the destination wallet\n* Solana Swap - Swap Solana tokens on Jupiter in the agent's wallet\n* Solana Balance - Get the token balances of a wallet\n* Solana Price - Get the price of a token\n* Solana SNS Lookup - Get the Solana address for a SNS domain\n* Rugcheck - Check if a token is a rug\n* Internet Search - Search the internet in real-time using Perplexity, Grok, or OpenAI\n* MCP - Interface with any MCP web server - Zapier is supported\n* Image Generation - Generate images with OpenAI, Grok, or Gemini with uploading to S3 compatible storage\n* Nemo Agent - Generate Python projects with Nemo Agent with uploading to S3 compatible storage\n\n## \ud83d\udce6 Installation\n\n```bash\npip install sakit\n```\n\n## \ud83d\udd0c Plugins\n\n### Solana Transfer\n\nThis plugin enables Solana Agent to transfer SOL and SPL tokens from the agent's wallet to the destination wallet.\n\nDon't use tickers - but mint addresses in your user queries.\n\n```python\nconfig = {\n \"tools\": {\n \"solana_transfer\": {\n \"rpc_url\": \"my-rpc-url\", # Required - your RPC URL - Helius is recommended\n \"private_key\": \"my-private-key\", # Required - base58 string - please use env vars to store the key as it is very confidential\n },\n },\n}\n```\n\n### Solana Swap\n\nThis plugin enables Solana Agent to swap tokens using Jupiter.\n\nDon't use tickers - but mint addresses in your user queries.\n\n```python\nconfig = {\n \"tools\": {\n \"solana_swap\": {\n \"rpc_url\": \"my-rpc-url\", # Required - your RPC URL - Helius is recommended\n \"private_key\": \"my-private-key\", # Required - base58 string - please use env vars to store the key as it is very confidential\n \"jupiter_url\": \"my-custom-url\" # Optional - if you are using a custom Jupiter service like Metis from QuickNode\n },\n },\n}\n```\n\n### Solana Balance\n\nThis plugin enables Solana Agent to get the token balances of a wallet.\n\n```python\nconfig = {\n \"tools\": {\n \"solana_balance\": {\n \"api_key\": \"my-alphavybe-api-key\", # Required - your AlphaVybe API key - the free plan allows this call\n },\n },\n}\n```\n\n### Solana Price\n\nThis plugin enables Solana Agent to get the price in USD of a token.\n\n```python\nconfig = {\n \"tools\": {\n \"solana_price\": {\n \"api_key\": \"my-birdeye-api-key\", # Required - your Birdeye API key - the free plan allows this call\n },\n },\n}\n```\n\n### Solana SNS Lookup\n\nThis plugin enables Solana Agent to get the Solana address of an SNS domain.\n\n```python\nconfig = {\n \"tools\": {\n \"sns_lookup\": {\n \"quicknode_url\": \"my-quicknode-rpc-url\", # Required - your QuickNode RPC URL with the SNS addon enabled\n },\n },\n}\n```\n\n\n### Rugcheck\n\nThis plugin enables Solana Agent to check if a token is a rug. \n\nNo config is needed.\n\n### Internet Search\nThis plugin enables Solana Agent to search the internet for up-to-date information using Perplexity or OpenAI.\n\nPlease ensure you include a prompt to instruct the agent to use the tool - otherwise it may not use it.\n\n```python\nconfig = { \n \"tools\": {\n \"search_internet\": {\n \"api_key\": \"your-api-key\", # Required - either a Perplexity, Grok, or OpenAI API key\n \"provider\": \"openai\", # Optional, defaults to openai - can be \"openai', \"perplexity\", or \"grok\" - grok also searches X\n \"citations\": True, # Optional, defaults to True - only applies for Perplexity and Grok\n \"model\": \"gpt-4o-mini-search-preview\" # Optional, defaults to \"sonar\" for Perplexity or \"gpt-4o-mini-search-preview\" for OpenAI or \"grok-3-mini-fast\" for Grok\n }\n },\n \"agents\": [\n {\n \"name\": \"research_specialist\",\n \"instructions\": \"You are an expert researcher who synthesizes complex information clearly. You use your search_internet tool to get the latest information.\",\n \"specialization\": \"Research and knowledge synthesis\",\n \"tools\": [\"search_internet\"], # Enable the tool for this agent\n }\n ]\n}\n```\n\n**Available Search Models for Perplexity**\n* sonar\n* sonar-pro\n\n**Available Search Models for OpenAI**\n* gpt-4o-mini-search-preview\n* gpt-4o-search-preview\n\n**Available Search Models for Grok**\n* grok-3\n* grok-3-fast\n* grok-3-mini\n* grok-3-mini-fast\n\n### MCP\n\n[Zapier](https://zapier.com/mcp) MCP has been tested, works, and is supported.\n\nZapier integrates over 7,000+ apps with 30,000+ actions that your AI Agent can utilize.\n\nOther MCP servers may work but are not supported.\n\nOpenAI is a requirement.\n\n```python\nconfig = {\n \"openai\": {\n \"api_key\": \"your-api-key\",\n },\n \"tools\": {\n \"mcp\": {\n \"url\": \"my-zapier-mcp-url\",\n }\n },\n \"agents\": [\n {\n \"name\": \"zapier_expert\",\n \"instructions\": \"You are an expert in using Zapier integrations using MCP. You always use the mcp tool to perform Zapier AI like actions.\",\n \"specialization\": \"Zapier service integration expert\",\n \"tools\": [\"mcp\"], # Enable the tool for this agent\n }\n ]\n}\n```\n\n### Image Generation\n\nThis plugin allows the agent to generate images using OpenAI's `gpt-image-1` model or Grok's `grok-2-image` and upload them to S3-compatible storage. It returns the public URL of the uploaded image.\n\nThis has been tested using [Cloudflare R2](https://developers.cloudflare.com/r2/).\n\n```python\nconfig = {\n \"tools\": {\n \"image_gen\": {\n \"provider\": \"openai\", # Required: either \"openai\", \"grok\", or \"gemini\"\n \"api_key\": \"your-api-key\", # Required: your OpenAI or Grok or Gemini API key\n \"s3_endpoint_url\": \"https://your-s3-endpoint.com\", # Required: e.g., https://nyc3.digitaloceanspaces.com\n \"s3_access_key_id\": \"YOUR_S3_ACCESS_KEY\", # Required: Your S3 access key ID\n \"s3_secret_access_key\": \"YOUR_S3_SECRET_KEY\", # Required: Your S3 secret access key\n \"s3_bucket_name\": \"your-bucket-name\", # Required: The name of your S3 bucket\n \"s3_region_name\": \"your-region\", # Optional: e.g., \"nyc3\", needed by some providers\n \"s3_public_url_base\": \"https://your-cdn-or-bucket-url.com/\", # Optional: Custom base URL for public links (include trailing slash). If omitted, a standard URL is constructed.\n }\n },\n \"agents\": [\n {\n \"name\": \"image_creator\",\n \"instructions\": \"You are a creative assistant that generates images based on user descriptions. Use the image_gen tool to create and store the image.\",\n \"specialization\": \"Image generation and storage\",\n \"tools\": [\"image_gen\"], # Enable the tool for this agent\n }\n ]\n}\n```\n\n**Image Models Used:**\n\n* OpenAI - `gpt-image-1`\n* Grok - `grok-2-image`\n* Gemini - `imagen-3.0-generate-002`\n\n\n### Nemo Agent\n\nThis plugin allows the agent to generate python programs using [Nemo Agent](https://nemo-agent.com) and uploads the files in a ZIP file to s3-compatible storage. It returns the public URL of the zip file.\n\nThis has been tested using [Cloudflare R2](https://developers.cloudflare.com/r2/).\n\n```python\nconfig = {\n \"tools\": {\n \"nemo_agent\": {\n \"provider\": \"openai\", # Required: either \"openai\" or \"gemini\"\n \"api_key\": \"your-api-key\", # Required: your OpenAI or Gemini API key\n \"s3_endpoint_url\": \"https://your-s3-endpoint.com\", # Required: e.g., https://nyc3.digitaloceanspaces.com\n \"s3_access_key_id\": \"YOUR_S3_ACCESS_KEY\", # Required: Your S3 access key ID\n \"s3_secret_access_key\": \"YOUR_S3_SECRET_KEY\", # Required: Your S3 secret access key\n \"s3_bucket_name\": \"your-bucket-name\", # Required: The name of your S3 bucket\n \"s3_region_name\": \"your-region\", # Optional: e.g., \"nyc3\", needed by some providers\n \"s3_public_url_base\": \"https://your-cdn-or-bucket-url.com/\", # Optional: Custom base URL for public links (include trailing slash). If omitted, a standard URL is constructed.\n }\n },\n \"agents\": [\n {\n \"name\": \"python_dev\",\n \"instructions\": \"You are an expert Python Developer. You always use your nemo_agent tool to generate python code.\",\n \"specialization\": \"Python Developer\",\n \"tools\": [\"nemo_agent\"], # Enable the tool for this agent\n }\n ]\n}\n```\n\n## \ud83e\udde9 Plugin Development\nWant to add your own plugins to Solana Agent Kit? Follow these guidelines:\n\n1. Create a new plugin directory under solana_agent_kit/\n2. Implement a plugin class that follows Solana Agent's plugin architecture\n3. Add your plugin to the list in __init__.py\n4. Test thoroughly\n5. Submit a PR!\n\n## \ud83d\udcc4 License\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Solana Agent Kit",
"version": "12.4.11",
"project_urls": {
"Repository": "https://github.com/truemagic-coder/solana-agent-kit"
},
"split_keywords": [
"ai",
" openai",
" ai agents",
" agi"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "75af0ed3ed8a877119c46dcf299fd1577c8de68e02c2fe177823801e7520d467",
"md5": "07b096b4bc6ac7b807f32b29065644b5",
"sha256": "24b2ce692a4a8a4aca88b45931d4feac2967c0a8b4216d5c7fc4591dfa0c2fb6"
},
"downloads": -1,
"filename": "sakit-12.4.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "07b096b4bc6ac7b807f32b29065644b5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.12",
"size": 43355,
"upload_time": "2025-07-26T01:31:57",
"upload_time_iso_8601": "2025-07-26T01:31:57.367163Z",
"url": "https://files.pythonhosted.org/packages/75/af/0ed3ed8a877119c46dcf299fd1577c8de68e02c2fe177823801e7520d467/sakit-12.4.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b1db4b110d1cc693ee2ac8377c2c53b5787130a00448b5313de91a8a0a664384",
"md5": "c5d964b69d8eafcecbfbc290cc575662",
"sha256": "68107182554a0ee6f3af8faeca75cb1fac38daf517f0d59e9ff3b3ae9a9e52f2"
},
"downloads": -1,
"filename": "sakit-12.4.11.tar.gz",
"has_sig": false,
"md5_digest": "c5d964b69d8eafcecbfbc290cc575662",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.12",
"size": 29545,
"upload_time": "2025-07-26T01:31:58",
"upload_time_iso_8601": "2025-07-26T01:31:58.562092Z",
"url": "https://files.pythonhosted.org/packages/b1/db/4b110d1cc693ee2ac8377c2c53b5787130a00448b5313de91a8a0a664384/sakit-12.4.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 01:31:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "truemagic-coder",
"github_project": "solana-agent-kit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sakit"
}