sakit


Namesakit JSON
Version 12.4.11 PyPI version JSON
download
home_pageNone
SummarySolana Agent Kit
upload_time2025-07-26 01:31:58
maintainerNone
docs_urlNone
authorBevan Hunt
requires_python<4.0,>=3.12
licenseMIT
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

[![PyPI - Version](https://img.shields.io/pypi/v/sakit)](https://pypi.org/project/sakit)
[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/sakit)](https://pypi.org/project/sakit/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Ruff Style](https://img.shields.io/badge/style-ruff-41B5BE)](https://github.com/astral-sh/ruff)
[![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/truemagic-coder/solana-agent-kit)](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[![PyPI - Version](https://img.shields.io/pypi/v/sakit)](https://pypi.org/project/sakit)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/sakit)](https://pypi.org/project/sakit/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![Ruff Style](https://img.shields.io/badge/style-ruff-41B5BE)](https://github.com/astral-sh/ruff)\n[![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/truemagic-coder/solana-agent-kit)](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"
}
        
Elapsed time: 0.43330s