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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 22.0.11
+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
@@ -244,10 +285,18 @@ config = {
 }
 ```
 
-### Disable Internet Searching
+### Internet Search
+
+This mode is great for text output where the default response from OpenAI is enough.
+
+However, it is also found to sometimes not not call tools when the tool should be called.
+
+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 and is not suitable for audio output.
 
 ```python
-async for response in solana_agent.process("user123", "Write me a poem.", internet_search=False):
+async for response in solana_agent.process("user123", "What is the latest news on Canada?", internet_search=True):
     print(response, end="")
 ```
 
@@ -292,7 +341,8 @@ config = {
     },
     "tools": {
         "search_internet": {
-            "api_key": "your-perplexity-api-key",
+            "api_key": "your-api-key", # Required - either a Perplexity or OpenAI API key
+            "provider": "perplexity", # Optional, defaults to perplexity - can also be openai (lowercase)
         },
     },
     "agents": [
@@ -312,7 +362,7 @@ config = {
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What are the latest AI developments?", internet_search=False):
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
     print(response, end="")
 ```
 
@@ -489,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-22.0.11 → 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
@@ -220,10 +261,18 @@ config = {
 }
 ```
 
-### Disable Internet Searching
+### Internet Search
+
+This mode is great for text output where the default response from OpenAI is enough.
+
+However, it is also found to sometimes not not call tools when the tool should be called.
+
+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 and is not suitable for audio output.
 
 ```python
-async for response in solana_agent.process("user123", "Write me a poem.", internet_search=False):
+async for response in solana_agent.process("user123", "What is the latest news on Canada?", internet_search=True):
     print(response, end="")
 ```
 
@@ -268,7 +317,8 @@ config = {
     },
     "tools": {
         "search_internet": {
-            "api_key": "your-perplexity-api-key",
+            "api_key": "your-api-key", # Required - either a Perplexity or OpenAI API key
+            "provider": "perplexity", # Optional, defaults to perplexity - can also be openai (lowercase)
         },
     },
     "agents": [
@@ -288,7 +338,7 @@ config = {
 
 solana_agent = SolanaAgent(config=config)
 
-async for response in solana_agent.process("user123", "What are the latest AI developments?", internet_search=False):
+async for response in solana_agent.process("user123", "What are the latest AI developments?"):
     print(response, end="")
 ```
 
@@ -465,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-22.0.11 → solana_agent-23.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "22.0.11"
+version = "23.0.1"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -30,7 +30,7 @@ zep-cloud = "^2.9.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.3.5"
-pytest-cov = "^6.1.0"
+pytest-cov = "^6.1.1"
 pytest-asyncio = "^0.26.0"
 pytest-mock = "^3.14.0"
 pytest-github-actions-annotate-failures = "^0.3.0"

{solana_agent-22.0.11 → solana_agent-23.0.1}/solana_agent/client/solana_agent.py

@@ -56,7 +56,7 @@ class SolanaAgent(SolanaAgentInterface):
             "flac", "mp3", "mp4", "mpeg", "mpga", "m4a", "ogg", "wav", "webm"
         ] = "mp4",
         router: Optional[RoutingInterface] = None,
-        internet_search: bool = True,
+        internet_search: bool = False,
     ) -> AsyncGenerator[Union[str, bytes], None]:  # pragma: no cover
         """Process a user message and return the response stream.
 

{solana_agent-22.0.11 → solana_agent-23.0.1}/solana_agent/interfaces/client/client.py

@@ -24,7 +24,7 @@ class SolanaAgent(ABC):
             "flac", "mp3", "mp4", "mpeg", "mpga", "m4a", "ogg", "wav", "webm"
         ] = "mp4",
         router: Optional[RoutingInterface] = None,
-        internet_search: bool = True,
+        internet_search: bool = False,
     ) -> AsyncGenerator[Union[str, bytes], None]:
         """Process a user message and return the response stream."""
         pass

{solana_agent-22.0.11 → solana_agent-23.0.1}/solana_agent/interfaces/services/agent.py

@@ -34,7 +34,7 @@ class AgentService(ABC):
             "flac", "mp3", "mp4", "mpeg", "mpga", "m4a", "ogg", "wav", "webm"
         ] = "mp4",
         prompt: Optional[str] = None,
-        internet_search: bool = True,
+        internet_search: bool = False,
     ) -> AsyncGenerator[Union[str, bytes], None]:
         """Generate a response from an agent."""
         pass

{solana_agent-22.0.11 → solana_agent-23.0.1}/solana_agent/interfaces/services/query.py

@@ -20,7 +20,7 @@ class QueryService(ABC):
             "flac", "mp3", "mp4", "mpeg", "mpga", "m4a", "ogg", "wav", "webm"
         ] = "mp4",
         prompt: Optional[str] = None,
-        internet_search: bool = True,
+        internet_search: bool = False,
     ) -> AsyncGenerator[Union[str, bytes], None]:
         """Process the user request and generate a response."""
         pass

{solana_agent-22.0.11 → solana_agent-23.0.1}/solana_agent/services/agent.py

@@ -177,7 +177,7 @@ class AgentService(AgentServiceInterface):
             "flac", "mp3", "mp4", "mpeg", "mpga", "m4a", "ogg", "wav", "webm"
         ] = "mp4",
         prompt: Optional[str] = None,
-        internet_search: bool = True,
+        internet_search: bool = False,
     ) -> AsyncGenerator[Union[str, bytes], None]:  # pragma: no cover
         """Generate a response with support for text/audio input/output."""
         agent = next((a for a in self.agents if a.name == agent_name), None)

{solana_agent-22.0.11 → solana_agent-23.0.1}/solana_agent/services/query.py

@@ -49,7 +49,7 @@ class QueryService(QueryServiceInterface):
         ] = "mp4",
         prompt: Optional[str] = None,
         router: Optional[RoutingServiceInterface] = None,
-        internet_search: bool = True,
+        internet_search: bool = False,
     ) -> AsyncGenerator[Union[str, bytes], None]:  # pragma: no cover
         """Process the user request with appropriate agent.