solana-agent 28.3.0__tar.gz → 28.3.2__tar.gz

solana_agent-28.3.0/README.md → solana_agent-28.3.2/PKG-INFO

@@ -1,3 +1,38 @@
+Metadata-Version: 2.3
+Name: solana-agent
+Version: 28.3.2
+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/)
@@ -29,9 +64,11 @@ Build your AI agents in three lines of code!
 * Business Alignment
 * Extensible Tooling
 * Automatic Tool Workflows
+* Autonomous Operation
 * Knowledge Base
 * MCP Support
 * Guardrails
+* Image Generation
 * Pydantic Logfire
 * Tested & Secure
 * Built in Python
@@ -56,7 +93,9 @@ 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
 
 ## Stack
 
@@ -78,6 +117,7 @@ Build your AI agents in three lines of code!
 * [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)
 * [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)
 
 ## Installation
 
@@ -568,6 +608,8 @@ class MyOutputGuardrail(OutputGuardrail):
 
 ## Tools
 
+Tools empower agents to interact with external systems, fetch data, or perform actions. They can be used reactively within a user conversation or proactively when an agent is triggered autonomously.
+
 Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
 
 * Agents can use multiple tools per response and should apply the right sequential order (like send an email to bob@bob.com with the latest news on Solana)
@@ -670,6 +712,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
@@ -750,6 +831,19 @@ async for response in solana_agent.process("user123", "What are the latest AI de
     print(response, end="")
 ```
 
+## Autonomous Operation & Event-Driven Agents
+
+While Solana Agent facilitates request-response interactions, the underlying architecture supports building autonomous agents. You can achieve autonomy by orchestrating calls based on external triggers rather than direct user input.
+
+**Key Concepts:**
+
+*   **External Triggers:** Use schedulers like cron, message queues (RabbitMQ, Kafka), monitoring systems, webhooks, or other event sources to initiate agent actions.
+*   **Programmatic Calls:** Instead of a user typing a message, your triggering system calls with a specific message (acting as instructions or data for the task) and potentially a dedicated user representing the autonomous process.
+*   **Tool-Centric Tasks:** Autonomous agents often focus on executing specific tools. The prompt can instruct the agent to use a particular tool with given parameters derived from the triggering event.
+*   **Example Scenario:** An agent could be triggered hourly by a scheduler. The `message` could be "Check the SOL balance for wallet X using the `solana` tool." The agent executes the tool, and the result could be logged or trigger another tool (e.g., using `mcp` to send an alert if the balance is low).
+
+By combining Solana Agent's agent definitions, tool integration, and routing with external orchestration, you can create sophisticated autonomous systems.
+
 ## Advanced Customization
 
 ### Runtime Prompt Injection
@@ -862,3 +956,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.0/PKG-INFO → solana_agent-28.3.2/README.md

@@ -1,38 +1,3 @@
-Metadata-Version: 2.3
-Name: solana-agent
-Version: 28.3.0
-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/)
@@ -64,9 +29,11 @@ Build your AI agents in three lines of code!
 * Business Alignment
 * Extensible Tooling
 * Automatic Tool Workflows
+* Autonomous Operation
 * Knowledge Base
 * MCP Support
 * Guardrails
+* Image Generation
 * Pydantic Logfire
 * Tested & Secure
 * Built in Python
@@ -91,7 +58,9 @@ 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
 
 ## Stack
 
@@ -113,6 +82,7 @@ Build your AI agents in three lines of code!
 * [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)
 * [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)
 
 ## Installation
 
@@ -603,6 +573,8 @@ class MyOutputGuardrail(OutputGuardrail):
 
 ## Tools
 
+Tools empower agents to interact with external systems, fetch data, or perform actions. They can be used reactively within a user conversation or proactively when an agent is triggered autonomously.
+
 Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools. Tools available via plugins integrate automatically with Solana Agent.
 
 * Agents can use multiple tools per response and should apply the right sequential order (like send an email to bob@bob.com with the latest news on Solana)
@@ -705,6 +677,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
@@ -785,6 +796,19 @@ async for response in solana_agent.process("user123", "What are the latest AI de
     print(response, end="")
 ```
 
+## Autonomous Operation & Event-Driven Agents
+
+While Solana Agent facilitates request-response interactions, the underlying architecture supports building autonomous agents. You can achieve autonomy by orchestrating calls based on external triggers rather than direct user input.
+
+**Key Concepts:**
+
+*   **External Triggers:** Use schedulers like cron, message queues (RabbitMQ, Kafka), monitoring systems, webhooks, or other event sources to initiate agent actions.
+*   **Programmatic Calls:** Instead of a user typing a message, your triggering system calls with a specific message (acting as instructions or data for the task) and potentially a dedicated user representing the autonomous process.
+*   **Tool-Centric Tasks:** Autonomous agents often focus on executing specific tools. The prompt can instruct the agent to use a particular tool with given parameters derived from the triggering event.
+*   **Example Scenario:** An agent could be triggered hourly by a scheduler. The `message` could be "Check the SOL balance for wallet X using the `solana` tool." The agent executes the tool, and the result could be logged or trigger another tool (e.g., using `mcp` to send an alert if the balance is low).
+
+By combining Solana Agent's agent definitions, tool integration, and routing with external orchestration, you can create sophisticated autonomous systems.
+
 ## Advanced Customization
 
 ### Runtime Prompt Injection
@@ -897,4 +921,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.0 → solana_agent-28.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "28.3.0"
+version = "28.3.2"
 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"