solana-agent 28.3.1__tar.gz → 28.3.3__tar.gz

solana_agent-28.3.1/README.md → solana_agent-28.3.3/PKG-INFO

@@ -1,3 +1,38 @@
+Metadata-Version: 2.3
+Name: solana-agent
+Version: 28.3.3
+Summary: AI Agents for Solana
+License: MIT
+Keywords: solana,solana ai,solana agent,ai,ai agent,ai agents
+Author: Bevan Hunt
+Author-email: bevan@bevanhunt.com
+Requires-Python: >=3.12,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Dist: instructor (==1.7.9)
+Requires-Dist: llama-index-core (==0.12.32)
+Requires-Dist: llama-index-embeddings-openai (==0.3.1)
+Requires-Dist: logfire (==3.14.1)
+Requires-Dist: openai (==1.76.2)
+Requires-Dist: pillow (==11.2.1)
+Requires-Dist: pinecone (==6.0.2)
+Requires-Dist: pydantic (>=2)
+Requires-Dist: pymongo (==4.12.1)
+Requires-Dist: pypdf (==5.4.0)
+Requires-Dist: rich (>=13,<14.0)
+Requires-Dist: scrubadub (==2.0.1)
+Requires-Dist: typer (==0.15.3)
+Requires-Dist: zep-cloud (==2.11.0)
+Project-URL: Documentation, https://docs.solana-agent.com
+Project-URL: Homepage, https://solana-agent.com
+Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
+Description-Content-Type: text/markdown
+
 # Solana Agent
 
 [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
@@ -33,6 +68,7 @@ Build your AI agents in three lines of code!
 * Knowledge Base
 * MCP Support
 * Guardrails
+* Image Generation
 * Pydantic Logfire
 * Tested & Secure
 * Built in Python
@@ -57,6 +93,7 @@ Build your AI agents in three lines of code!
 * Assigned tools are utilized by agents automatically and effectively
 * Integrated Knowledge Base with semantic search and automatic PDF chunking
 * Input and output guardrails for content filtering, safety, and data sanitization
+* Generate custom images based on text prompts with storage on S3 compatible services
 * Automatic sequential tool workflows allowing agents to chain multiple tools
 * Combine with event-driven systems to create autonomous agents
 
@@ -77,9 +114,11 @@ Build your AI agents in three lines of code!
 
 * [gpt-4.1](https://platform.openai.com/docs/models/gpt-4.1) (agent)
 * [gpt-4.1-nano](https://platform.openai.com/docs/models/gpt-4.1-nano) (router)
-* [text-embedding-3-large](https://platform.openai.com/docs/models/text-embedding-3-large) or [text-embedding-3-small](https://platform.openai.com/docs/models/text-embedding-3-small) (embedding)
+* [text-embedding-3-large](https://platform.openai.com/docs/models/text-embedding-3-large) (embedding)
 * [tts-1](https://platform.openai.com/docs/models/tts-1) (audio TTS)
 * [gpt-4o-mini-transcribe](https://platform.openai.com/docs/models/gpt-4o-mini-transcribe) (audio transcription)
+* [gpt-image-1](https://platform.openai.com/docs/models/gpt-image-1) (image generation)
+* [gpt-4o-mini-search-preview](https://platform.openai.com/docs/models/gpt-4o-mini-search-preview) (Internet search)
 
 ## Installation
 
@@ -674,6 +713,45 @@ async for response in solana_agent.process("user123", "Send an email to bob@bob.
     print(response, end="")
 ```
 
+### Image Generation
+
+Generate images using OpenAI's `gpt-image-1` and upload them to S3-compatible storage.
+
+`pip install sakit`
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
+    "openai": {
+        "api_key": "your-openai-api-key" # Required: Your OpenAI API key
+    },
+    "tools": {
+        "image_gen": {
+            "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
+        }
+    ]
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "Generate an image of a smiling unicorn!"):
+    print(response, end="")
+```
+
 ### Inline Tool Example
 
 ```python
@@ -879,3 +957,4 @@ To run the test suite locally run `poetry run pytest --cov=solana_agent --cov-re
 ## License
 
 This project is licensed under the MIT License - see the LICENSE file for details.
+

solana_agent-28.3.1/PKG-INFO → solana_agent-28.3.3/README.md

@@ -1,38 +1,3 @@
-Metadata-Version: 2.3
-Name: solana-agent
-Version: 28.3.1
-Summary: AI Agents for Solana
-License: MIT
-Keywords: solana,solana ai,solana agent,ai,ai agent,ai agents
-Author: Bevan Hunt
-Author-email: bevan@bevanhunt.com
-Requires-Python: >=3.12,<4.0
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Dist: instructor (>=1.7.9,<2.0.0)
-Requires-Dist: llama-index-core (>=0.12.32,<0.13.0)
-Requires-Dist: llama-index-embeddings-openai (>=0.3.1,<0.4.0)
-Requires-Dist: logfire (>=3.14.0,<4.0.0)
-Requires-Dist: openai (>=1.75.0,<2.0.0)
-Requires-Dist: pillow (>=11.2.1,<12.0.0)
-Requires-Dist: pinecone (>=6.0.2,<7.0.0)
-Requires-Dist: pydantic (>=2)
-Requires-Dist: pymongo (>=4.12.0,<5.0.0)
-Requires-Dist: pypdf (>=5.4.0,<6.0.0)
-Requires-Dist: rich (>=13)
-Requires-Dist: scrubadub (>=2.0.1,<3.0.0)
-Requires-Dist: typer (>=0.15.2,<0.16.0)
-Requires-Dist: zep-cloud (>=2.10.2,<3.0.0)
-Project-URL: Documentation, https://docs.solana-agent.com
-Project-URL: Homepage, https://solana-agent.com
-Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
-Description-Content-Type: text/markdown
-
 # Solana Agent
 
 [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
@@ -68,6 +33,7 @@ Build your AI agents in three lines of code!
 * Knowledge Base
 * MCP Support
 * Guardrails
+* Image Generation
 * Pydantic Logfire
 * Tested & Secure
 * Built in Python
@@ -92,6 +58,7 @@ Build your AI agents in three lines of code!
 * Assigned tools are utilized by agents automatically and effectively
 * Integrated Knowledge Base with semantic search and automatic PDF chunking
 * Input and output guardrails for content filtering, safety, and data sanitization
+* Generate custom images based on text prompts with storage on S3 compatible services
 * Automatic sequential tool workflows allowing agents to chain multiple tools
 * Combine with event-driven systems to create autonomous agents
 
@@ -112,9 +79,11 @@ Build your AI agents in three lines of code!
 
 * [gpt-4.1](https://platform.openai.com/docs/models/gpt-4.1) (agent)
 * [gpt-4.1-nano](https://platform.openai.com/docs/models/gpt-4.1-nano) (router)
-* [text-embedding-3-large](https://platform.openai.com/docs/models/text-embedding-3-large) or [text-embedding-3-small](https://platform.openai.com/docs/models/text-embedding-3-small) (embedding)
+* [text-embedding-3-large](https://platform.openai.com/docs/models/text-embedding-3-large) (embedding)
 * [tts-1](https://platform.openai.com/docs/models/tts-1) (audio TTS)
 * [gpt-4o-mini-transcribe](https://platform.openai.com/docs/models/gpt-4o-mini-transcribe) (audio transcription)
+* [gpt-image-1](https://platform.openai.com/docs/models/gpt-image-1) (image generation)
+* [gpt-4o-mini-search-preview](https://platform.openai.com/docs/models/gpt-4o-mini-search-preview) (Internet search)
 
 ## Installation
 
@@ -709,6 +678,45 @@ async for response in solana_agent.process("user123", "Send an email to bob@bob.
     print(response, end="")
 ```
 
+### Image Generation
+
+Generate images using OpenAI's `gpt-image-1` and upload them to S3-compatible storage.
+
+`pip install sakit`
+
+```python
+from solana_agent import SolanaAgent
+
+config = {
+    "openai": {
+        "api_key": "your-openai-api-key" # Required: Your OpenAI API key
+    },
+    "tools": {
+        "image_gen": {
+            "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
+        }
+    ]
+}
+
+solana_agent = SolanaAgent(config=config)
+
+async for response in solana_agent.process("user123", "Generate an image of a smiling unicorn!"):
+    print(response, end="")
+```
+
 ### Inline Tool Example
 
 ```python
@@ -914,4 +922,3 @@ To run the test suite locally run `poetry run pytest --cov=solana_agent --cov-re
 ## License
 
 This project is licensed under the MIT License - see the LICENSE file for details.
-

{solana_agent-28.3.1 → solana_agent-28.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "28.3.1"
+version = "28.3.3"
 description = "AI Agents for Solana"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -24,20 +24,20 @@ python_paths = [".", "tests"]
 
 [tool.poetry.dependencies]
 python = ">=3.12,<4.0"
-openai = "^1.75.0"
+openai = "1.76.2"
 pydantic = ">=2"
-pymongo = "^4.12.0"
-zep-cloud = "^2.10.2"
-instructor = "^1.7.9"
-pinecone = "^6.0.2"
-llama-index-core = "^0.12.32"
-llama-index-embeddings-openai = "^0.3.1"
-pypdf = "^5.4.0"
-scrubadub = "^2.0.1"
-logfire = "^3.14.0"
-typer = "^0.15.2"
-rich = ">=13"
-pillow = "^11.2.1"
+pymongo = "4.12.1"
+zep-cloud = "2.11.0"
+instructor = "1.7.9"
+pinecone = "6.0.2"
+llama-index-core = "0.12.32"
+llama-index-embeddings-openai = "0.3.1"
+pypdf = "5.4.0"
+scrubadub = "2.0.1"
+logfire = "3.14.1"
+typer = "0.15.3"
+rich = ">=13,<14.0"
+pillow = "11.2.1"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.3.5"
@@ -50,7 +50,7 @@ sphinx-rtd-theme = "^3.0.2"
 myst-parser = "^4.0.1"
 sphinx-autobuild = "^2024.10.3"
 mongomock = "^4.3.0"
-ruff = "^0.11.6"
+ruff = "^0.11.7"
 
 [tool.poetry.scripts]
 solana-agent = "solana_agent.cli:app"