solana-agent 26.0.0__tar.gz → 27.1.0__tar.gz

{solana_agent-26.0.0 → solana_agent-27.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: solana-agent
-Version: 26.0.0
+Version: 27.1.0
 Summary: Agentic IQ
 License: MIT
 Keywords: ai,openai,ai agents,agi
@@ -15,10 +15,10 @@ 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: openai (>=1.71.0,<2.0.0)
-Requires-Dist: pydantic (>=2.11.2,<3.0.0)
-Requires-Dist: pymongo (>=4.11.3,<5.0.0)
-Requires-Dist: zep-cloud (>=2.9.0,<3.0.0)
+Requires-Dist: openai (>=1.72.0,<2.0.0)
+Requires-Dist: pydantic (>=2.11.3,<3.0.0)
+Requires-Dist: pymongo (>=4.12.0,<5.0.0)
+Requires-Dist: zep-cloud (>=2.10.1,<3.0.0)
 Project-URL: Documentation, https://docs.solana-agent.com
 Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
 Description-Content-Type: text/markdown
@@ -76,16 +76,25 @@ Build your AI business in three lines of code!
 ### Tech
 
 * [Python](https://python.org) - Programming Language
-* [OpenAI](https://openai.com) & [Gemini](https://aistudio.google.com/) - LLM Providers
+* [OpenAI](https://openai.com), [Google](https://ai.google.dev), [xAI](https://x.ai) - LLM Providers
 * [MongoDB](https://mongodb.com) - Conversational History (optional)
 * [Zep Cloud](https://getzep.com) - Conversational Memory (optional)
 
 ### LLMs
 
-* [gemini-2.0-flash](https://ai.google.dev/gemini-api/docs/models#gemini-2.0-flash) or [gpt-4o-mini](https://platform.openai.com/docs/models/gpt-4o-mini)
+* [gpt-4o-mini](https://platform.openai.com/docs/models/gpt-4o-mini)
+* [gemini-2.0-flash](https://ai.google.dev/gemini-api/docs/models#gemini-2.0-flash)
+* [grok-3-mini-fast-beta](https://docs.x.ai/docs/models#models-and-pricing)
 * [tts-1](https://platform.openai.com/docs/models/tts-1)
 * [gpt-4o-mini-transcribe](https://platform.openai.com/docs/models/gpt-4o-mini-transcribe)
 
+It is recommended to use all three LLM providers as it is the best setup.
+
+Gemini makes the routing about 2x faster.
+
+Grok is a fast reasoning model and makes the answers and conversation much better.
+
+OpenAI is required while Gemini and Grok are optional.
 
 ## Installation
 
@@ -146,6 +155,9 @@ Keep this in mind while designing your agentic systems using Solana Agent.
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -178,6 +190,9 @@ async for response in solana_agent.process("user123", "What are the latest AI de
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -212,6 +227,9 @@ async for response in solana_agent.process("user123", audio_content, output_form
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -244,6 +262,9 @@ async for response in solana_agent.process("user123", "What is the latest news o
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -330,6 +351,9 @@ Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -415,6 +439,9 @@ class TestTool(Tool):
             }
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -457,6 +484,9 @@ This knowledge is accessible to all your AI agents.
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -487,6 +517,9 @@ from solana_agent import SolanaAgent
 from solana_agent.interfaces.services.routing import RoutingService as RoutingServiceInterface
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -542,6 +575,12 @@ The official example app written in FastAPI and Next.js
 
 [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
 
+## Demo App
+
+The official demo app written in FastAPI and Next.js
+
+[Solana Agent Demo App](https://demo.solana-agent.com)
+
 ## Agent Framework Comparisons
 
 [Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/wiki/Agent-Framework-Comparisons)

{solana_agent-26.0.0 → solana_agent-27.1.0}/README.md

@@ -51,16 +51,25 @@ Build your AI business in three lines of code!
 ### Tech
 
 * [Python](https://python.org) - Programming Language
-* [OpenAI](https://openai.com) & [Gemini](https://aistudio.google.com/) - LLM Providers
+* [OpenAI](https://openai.com), [Google](https://ai.google.dev), [xAI](https://x.ai) - LLM Providers
 * [MongoDB](https://mongodb.com) - Conversational History (optional)
 * [Zep Cloud](https://getzep.com) - Conversational Memory (optional)
 
 ### LLMs
 
-* [gemini-2.0-flash](https://ai.google.dev/gemini-api/docs/models#gemini-2.0-flash) or [gpt-4o-mini](https://platform.openai.com/docs/models/gpt-4o-mini)
+* [gpt-4o-mini](https://platform.openai.com/docs/models/gpt-4o-mini)
+* [gemini-2.0-flash](https://ai.google.dev/gemini-api/docs/models#gemini-2.0-flash)
+* [grok-3-mini-fast-beta](https://docs.x.ai/docs/models#models-and-pricing)
 * [tts-1](https://platform.openai.com/docs/models/tts-1)
 * [gpt-4o-mini-transcribe](https://platform.openai.com/docs/models/gpt-4o-mini-transcribe)
 
+It is recommended to use all three LLM providers as it is the best setup.
+
+Gemini makes the routing about 2x faster.
+
+Grok is a fast reasoning model and makes the answers and conversation much better.
+
+OpenAI is required while Gemini and Grok are optional.
 
 ## Installation
 
@@ -121,6 +130,9 @@ Keep this in mind while designing your agentic systems using Solana Agent.
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -153,6 +165,9 @@ async for response in solana_agent.process("user123", "What are the latest AI de
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -187,6 +202,9 @@ async for response in solana_agent.process("user123", audio_content, output_form
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -219,6 +237,9 @@ async for response in solana_agent.process("user123", "What is the latest news o
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -305,6 +326,9 @@ Tools can be used from plugins like Solana Agent Kit (sakit) or via inline tools
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -390,6 +414,9 @@ class TestTool(Tool):
             }
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -432,6 +459,9 @@ This knowledge is accessible to all your AI agents.
 from solana_agent import SolanaAgent
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -462,6 +492,9 @@ from solana_agent import SolanaAgent
 from solana_agent.interfaces.services.routing import RoutingService as RoutingServiceInterface
 
 config = {
+    "grok": {
+        "api_key": "your-grok-api-key",
+    },
     "gemini": {
         "api_key": "your-gemini-api-key",
     },
@@ -517,6 +550,12 @@ The official example app written in FastAPI and Next.js
 
 [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
 
+## Demo App
+
+The official demo app written in FastAPI and Next.js
+
+[Solana Agent Demo App](https://demo.solana-agent.com)
+
 ## Agent Framework Comparisons
 
 [Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/wiki/Agent-Framework-Comparisons)

{solana_agent-26.0.0 → solana_agent-27.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solana-agent"
-version = "26.0.0"
+version = "27.1.0"
 description = "Agentic IQ"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"
@@ -23,10 +23,10 @@ python_paths = [".", "tests"]
 
 [tool.poetry.dependencies]
 python = ">=3.12,<4.0"
-openai = "^1.71.0"
-pydantic = "^2.11.2"
-pymongo = "^4.11.3"
-zep-cloud = "^2.9.0"
+openai = "^1.72.0"
+pydantic = "^2.11.3"
+pymongo = "^4.12.0"
+zep-cloud = "^2.10.1"
 instructor = "^1.7.9"
 
 [tool.poetry.group.dev.dependencies]

{solana_agent-26.0.0 → solana_agent-27.1.0}/solana_agent/adapters/llm_adapter.py

@@ -170,7 +170,6 @@ class OpenAIAdapter(LLMProvider):
             if model:
                 self.parse_model = model
 
-            # Create a patched client with TOOLS_STRICT mode
             patched_client = instructor.from_openai(
                 client, mode=Mode.TOOLS_STRICT)
 
@@ -187,9 +186,17 @@ class OpenAIAdapter(LLMProvider):
                 f"Error with instructor parsing (TOOLS_STRICT mode): {e}")
 
             try:
+                if api_key and base_url:
+                    client = AsyncOpenAI(api_key=api_key, base_url=base_url)
+                else:
+                    client = self.client
+
+                if model:
+                    self.parse_model = model
+
                 # First fallback: Try regular JSON mode
                 patched_client = instructor.from_openai(
-                    self.client, mode=Mode.JSON)
+                    client, mode=Mode.JSON)
                 response = await patched_client.chat.completions.create(
                     model=self.parse_model,
                     messages=messages,
@@ -201,6 +208,15 @@ class OpenAIAdapter(LLMProvider):
                 print(f"JSON mode fallback also failed: {json_error}")
 
                 try:
+                    if api_key and base_url:
+                        client = AsyncOpenAI(
+                            api_key=api_key, base_url=base_url)
+                    else:
+                        client = self.client
+
+                    if model:
+                        self.parse_model = model
+
                     # Final fallback: Manual extraction with a detailed prompt
                     fallback_system_prompt = f"""
                     {system_prompt}
@@ -212,7 +228,7 @@ class OpenAIAdapter(LLMProvider):
                     """
 
                     # Regular completion without instructor
-                    completion = await self.client.chat.completions.create(
+                    completion = await client.chat.completions.create(
                         model=self.parse_model,
                         messages=[
                             {"role": "system", "content": fallback_system_prompt},

{solana_agent-26.0.0 → solana_agent-27.1.0}/solana_agent/factories/agent_factory.py

@@ -86,7 +86,7 @@ class SolanaAgentFactory:
                 zep_api_key=config["zep"].get("api_key")
             )
 
-        if "gemini" in config and "api_key" in config["gemini"]:
+        if "gemini" in config and "api_key" in config["gemini"] and not "grok" in config:
             # Create primary services
             agent_service = AgentService(
                 llm_provider=llm_adapter,
@@ -105,6 +105,43 @@ class SolanaAgentFactory:
                 base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
                 model="gemini-2.0-flash",
             )
+
+        elif "gemini" in config and "api_key" in config["gemini"] and "grok" in config and "api_key" in config["grok"]:
+            # Create primary services
+            agent_service = AgentService(
+                llm_provider=llm_adapter,
+                business_mission=business_mission,
+                config=config,
+                api_key=config["grok"]["api_key"],
+                base_url="https://api.x.ai/v1",
+                model="grok-3-mini-fast-beta",
+            )
+            # Create routing service
+            routing_service = RoutingService(
+                llm_provider=llm_adapter,
+                agent_service=agent_service,
+                api_key=config["gemini"]["api_key"],
+                base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
+                model="gemini-2.0-flash",
+            )
+
+        elif "grok" in config and "api_key" in config["grok"] and not "gemini" in config:
+            # Create primary services
+            agent_service = AgentService(
+                llm_provider=llm_adapter,
+                business_mission=business_mission,
+                config=config,
+                api_key=config["grok"]["api_key"],
+                base_url="https://api.x.ai/v1",
+                model="grok-3-mini-fast-beta",
+            )
+
+            # Create routing service
+            routing_service = RoutingService(
+                llm_provider=llm_adapter,
+                agent_service=agent_service,
+            )
+
         else:
             # Create primary services
             agent_service = AgentService(