solana-agent 23.0.0__tar.gz → 23.0.1__tar.gz

{solana_agent-23.0.0 → solana_agent-23.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 23.0.0
+Version: 23.0.1
 Summary: Agentic IQ
 License: MIT
 Keywords: ai,openai,ai agents,agi
@@ -81,6 +81,47 @@ You can install Solana Agent using pip:
 
 `pip install solana-agent`
 
+## Flows
+
+In both flows of single and multiple agents - it is one user query to one agent using one tool (if needed).
+
+An agent can have multiple tools and will choose the best one to answer the user query.
+
+Routing is determined by optimal domain expertise of the agent for the user query.
+
+Keep this in mind while designing your agentic systems using Solana Agent.
+
+```ascii
+                       Single Agent                                     
+                                                                        
+     ┌────────┐        ┌─────────┐        ┌────────┐                    
+     │        │        │         │        │        │                    
+     │        │        │         │        │        │                    
+     │  User  │◄──────►│  Agent  │◄──────►│  Tool  │                    
+     │        │        │         │        │        │                    
+     │        │        │         │        │        │                    
+     └────────┘        └─────────┘        └────────┘                    
+                                                                        
+                                                                        
+                                                                        
+                                                                        
+                                                                        
+                      Multiple Agents                                   
+                                                                        
+     ┌────────┐        ┌──────────┐        ┌─────────┐        ┌────────┐
+     │        │        │          │        │         │        │        │
+     │        │        │          │        │         │        │        │
+┌───►│  User  ├───────►│  Router  ├───────►│  Agent  │◄──────►│  Tool  │
+│    │        │        │          │        │         │        │        │
+│    │        │        │          │        │         │        │        │
+│    └────────┘        └──────────┘        └────┬────┘        └────────┘
+│                                               │                       
+│                                               │                       
+│                                               │                       
+│                                               │                       
+└───────────────────────────────────────────────┘                       
+```
+
 ## Usage
 
 ### Text/Text Streaming
@@ -252,10 +293,10 @@ However, it is also found to sometimes not not call tools when the tool should b
 
 It is faster than calling `search_internet` from `sakit` and saves at least 2 API calls.
 
-The default mode is disabled due to the issue of not calling tools properly.
+The default mode is disabled due to the issue of not calling tools properly and is not suitable for audio output.
 
 ```python
-async for response in solana_agent.process("user123", "Write me a poem.", internet_search=True):
+async for response in solana_agent.process("user123", "What is the latest news on Canada?", internet_search=True):
     print(response, end="")
 ```
 
@@ -498,7 +539,19 @@ The official example app written in FastAPI and Next.js
 
 ## Agent Framework Comparisons
 
-[Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/blob/main/compare.md)
+[Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/wiki/Agent-Framework-Comparisons)
+
+## Contributing
+
+If you have a question, feedback, or feature request - please open a GitHub discussion.
+
+If you find a bug - please open a GitHub issue.
+
+We are currently not accepting pull requests at the moment.
+
+To run the documentation site locally run `make livehtml` in the root directory.
+
+To run the test suite locally run `poetry run pytest --cov=solana_agent --cov-report=html` in the root directory.
 
 ## License
 

{solana_agent-23.0.0 → solana_agent-23.0.1}/README.md

@@ -57,6 +57,47 @@ You can install Solana Agent using pip:
 
 `pip install solana-agent`
 
+## Flows
+
+In both flows of single and multiple agents - it is one user query to one agent using one tool (if needed).
+
+An agent can have multiple tools and will choose the best one to answer the user query.
+
+Routing is determined by optimal domain expertise of the agent for the user query.
+
+Keep this in mind while designing your agentic systems using Solana Agent.
+
+```ascii
+                       Single Agent                                     
+                                                                        
+     ┌────────┐        ┌─────────┐        ┌────────┐                    
+     │        │        │         │        │        │                    
+     │        │        │         │        │        │                    
+     │  User  │◄──────►│  Agent  │◄──────►│  Tool  │                    
+     │        │        │         │        │        │                    
+     │        │        │         │        │        │                    
+     └────────┘        └─────────┘        └────────┘                    
+                                                                        
+                                                                        
+                                                                        
+                                                                        
+                                                                        
+                      Multiple Agents                                   
+                                                                        
+     ┌────────┐        ┌──────────┐        ┌─────────┐        ┌────────┐
+     │        │        │          │        │         │        │        │
+     │        │        │          │        │         │        │        │
+┌───►│  User  ├───────►│  Router  ├───────►│  Agent  │◄──────►│  Tool  │
+│    │        │        │          │        │         │        │        │
+│    │        │        │          │        │         │        │        │
+│    └────────┘        └──────────┘        └────┬────┘        └────────┘
+│                                               │                       
+│                                               │                       
+│                                               │                       
+│                                               │                       
+└───────────────────────────────────────────────┘                       
+```
+
 ## Usage
 
 ### Text/Text Streaming
@@ -228,10 +269,10 @@ However, it is also found to sometimes not not call tools when the tool should b
 
 It is faster than calling `search_internet` from `sakit` and saves at least 2 API calls.
 
-The default mode is disabled due to the issue of not calling tools properly.
+The default mode is disabled due to the issue of not calling tools properly and is not suitable for audio output.
 
 ```python
-async for response in solana_agent.process("user123", "Write me a poem.", internet_search=True):
+async for response in solana_agent.process("user123", "What is the latest news on Canada?", internet_search=True):
     print(response, end="")
 ```
 
@@ -474,7 +515,19 @@ The official example app written in FastAPI and Next.js
 
 ## Agent Framework Comparisons
 
-[Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/blob/main/compare.md)
+[Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/wiki/Agent-Framework-Comparisons)
+
+## Contributing
+
+If you have a question, feedback, or feature request - please open a GitHub discussion.
+
+If you find a bug - please open a GitHub issue.
+
+We are currently not accepting pull requests at the moment.
+
+To run the documentation site locally run `make livehtml` in the root directory.
+
+To run the test suite locally run `poetry run pytest --cov=solana_agent --cov-report=html` in the root directory.
 
 ## License
 

{solana_agent-23.0.0 → solana_agent-23.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "23.0.0"
+version = "23.0.1"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"