solana-agent 20.1.2__py3-none-any.whl → 31.4.0__py3-none-any.whl

solana_agent-31.4.0.dist-info/RECORD

@@ -0,0 +1,49 @@
+solana_agent/__init__.py,sha256=iu0PnSAEZ6qzzHFVu7WVCQVbeCZmiZ6axUDDgWRn1j4,1070
+solana_agent/adapters/__init__.py,sha256=tiEEuuy0NF3ngc_tGEcRTt71zVI58v3dYY9RvMrF2Cg,204
+solana_agent/adapters/ffmpeg_transcoder.py,sha256=d2T6hDBZe_beLkZTJiWSKeeOB47U12-dF4o4PXehnKU,12166
+solana_agent/adapters/mongodb_adapter.py,sha256=Hq3S8VzfLmnPjV40z8yJXGqUamOJcX5GbOMd-1nNWO4,3175
+solana_agent/adapters/openai_adapter.py,sha256=vesYtOdMhGR2Q_kQ2GpJ8PHJzL1UYFYACkHr91GMSkA,27867
+solana_agent/adapters/openai_realtime_ws.py,sha256=z9iJOmAw9skKqrO9d4fvCYl7ZPR-KVBhlYclBrMqQxI,84343
+solana_agent/adapters/pinecone_adapter.py,sha256=XlfOpoKHwzpaU4KZnovO2TnEYbsw-3B53ZKQDtBeDgU,23847
+solana_agent/cli.py,sha256=FGvTIQmKLp6XsQdyKtuhIIfbBtMmcCCXfigNrj4bzMc,4704
+solana_agent/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+solana_agent/client/solana_agent.py,sha256=MXqoIS5oD9tSdMj76Dqh0__YUqlYoqgkScDE7iYQkjM,10666
+solana_agent/domains/__init__.py,sha256=HiC94wVPRy-QDJSSRywCRrhrFfTBeHjfi5z-QfZv46U,168
+solana_agent/domains/agent.py,sha256=8pAi1-kIgzFNANt3dyQjw-1zbThcNdpEllbAGWi79uI,2841
+solana_agent/domains/routing.py,sha256=rb7YyeH4CJmjtuoBMk7f8kUFddcT5tUBZ9Bj8mJ4VV8,845
+solana_agent/factories/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+solana_agent/factories/agent_factory.py,sha256=fgRa-mnMlNWYMC8jLEkeaa1hUcjT2u8e-5ICXZHtKm4,15364
+solana_agent/guardrails/pii.py,sha256=FCz1IC3mmkr41QFFf5NaC0fwJrVkwFsxgyOCS2POO5I,4428
+solana_agent/interfaces/__init__.py,sha256=IQs1WIM1FeKP1-kY2FEfyhol_dB-I-VAe2rD6jrVF6k,355
+solana_agent/interfaces/client/client.py,sha256=XAp3BmY4N-RlYJHJOfGJl8PBEk9fiy0RsEDmmP7LLRk,3823
+solana_agent/interfaces/guardrails/guardrails.py,sha256=gZCQ1FrirW-mX6s7FoYrbRs6golsp-x269kk4kQiZzc,572
+solana_agent/interfaces/plugins/plugins.py,sha256=Rz52cWBLdotwf4kV-2mC79tRYlN29zHSu1z9-y1HVPk,3329
+solana_agent/interfaces/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+solana_agent/interfaces/providers/audio.py,sha256=CescIuGBEUQZ4XRyxb_1VYrO9x3Q80ilp-sxpYpxAyQ,1213
+solana_agent/interfaces/providers/data_storage.py,sha256=Y92Cq8BtC55VlsYLD7bo3ofqQabNnlg7Q4H1Q6CDsLU,1713
+solana_agent/interfaces/providers/llm.py,sha256=EnOfGH4bjg_EjTP6dUxxcdvKFn3NKfcpVyATUlJuARA,3563
+solana_agent/interfaces/providers/memory.py,sha256=28X1LeS-bEac4yoIXdRPyuRU91oW9Kdt2NZtDmwSTxM,1360
+solana_agent/interfaces/providers/realtime.py,sha256=gbNKuTyfB5L1zbKhxAJaD8QiSaRr__0Xe0mvgrwpxkk,6557
+solana_agent/interfaces/providers/vector_storage.py,sha256=XPYzvoWrlDVFCS9ItBmoqCFWXXWNYY-d9I7_pvP7YYk,1561
+solana_agent/interfaces/services/agent.py,sha256=Hz3ldNb0NDMp8Rm9E3GM0L3kMAO3XLJ6U2HAh6gdPeU,2176
+solana_agent/interfaces/services/knowledge_base.py,sha256=Mu8lCGFXPmI_IW5LRGti7octLoWZIg4k5PmGwPfe7LQ,1479
+solana_agent/interfaces/services/query.py,sha256=M_sq9TZl3tzXUe6Yz3RcCqinJStVGbmHsAOnIqgzUaM,2177
+solana_agent/interfaces/services/routing.py,sha256=Qbn3-DQGVSQKaegHDekSFmn_XCklA0H2f0XUx9-o3wA,367
+solana_agent/plugins/__init__.py,sha256=coZdgJKq1ExOaj6qB810i3rEhbjdVlrkN76ozt_Ojgo,193
+solana_agent/plugins/manager.py,sha256=mO_dKSVJ8GToD3wZflMcpKDEBXRoaaMRtY267HENCI0,5542
+solana_agent/plugins/registry.py,sha256=VAG0BWdUUIsEE-VpATtHi8qat7ziPuh7pKuzGXauwgc,4173
+solana_agent/plugins/tools/__init__.py,sha256=VDjJxvUjefIy10VztQ9WDKgIegvDbIXBQWsHLhxdZ3o,125
+solana_agent/plugins/tools/auto_tool.py,sha256=uihijtlc9CCqCIaRcwPuuN7o1SHIpWL2GV3vr33GG3E,1576
+solana_agent/repositories/__init__.py,sha256=fP83w83CGzXLnSdq-C5wbw9EhWTYtqE2lQTgp46-X_4,163
+solana_agent/repositories/memory.py,sha256=cipt9eC5YApi8ozFXAV5xq7QxQJExJmVdgGjkBjHwF0,17279
+solana_agent/services/__init__.py,sha256=iko0c2MlF8b_SA_nuBGFllr2E3g_JowOrOzGcnU9tkA,162
+solana_agent/services/agent.py,sha256=OS_7kQ5VxR3B2Xw1Ce3IaGpeHGFuEtobVjTYtkO1slc,23219
+solana_agent/services/knowledge_base.py,sha256=ZvOPrSmcNDgUzz4bJIQ4LeRl9vMZiK9hOfs71IpB7Bk,32735
+solana_agent/services/query.py,sha256=YTsRHesrFqzKc5ARdBl60MN8lJNjlk_-S_AV_G7ymbk,91075
+solana_agent/services/realtime.py,sha256=knjExZZd-a5_gvks9p2Sje9QKcAeZ_1oaLiREKFmsc0,25168
+solana_agent/services/routing.py,sha256=wT8XctVrbR5UoZhUSGX_H68XucpCr3KG71SVElWE3CQ,9114
+solana_agent-31.4.0.dist-info/METADATA,sha256=-k8dmQdeSLwb80fl6dhzkurC5nD1rBQuBlHHv14P-54,37027
+solana_agent-31.4.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+solana_agent-31.4.0.dist-info/entry_points.txt,sha256=-AuT_mfqk8dlZ0pHuAjx1ouAWpTRjpqvEUa6YV3lmc0,53
+solana_agent-31.4.0.dist-info/licenses/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
+solana_agent-31.4.0.dist-info/RECORD,,

{solana_agent-20.1.2.dist-info → solana_agent-31.4.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.1
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any

solana_agent-31.4.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+solana-agent=solana_agent.cli:app
+

solana_agent/adapters/llm_adapter.py

@@ -1,160 +0,0 @@
-"""
-LLM provider adapters for the Solana Agent system.
-
-These adapters implement the LLMProvider interface for different LLM services.
-"""
-from typing import AsyncGenerator, List, Literal, Type, TypeVar, Union
-
-from openai import OpenAI
-from pydantic import BaseModel
-
-from solana_agent.interfaces.providers.llm import LLMProvider
-
-T = TypeVar('T', bound=BaseModel)
-
-
-class OpenAIAdapter(LLMProvider):
-    """OpenAI implementation of LLMProvider with web search capabilities."""
-
-    def __init__(self, api_key: str):
-        self.client = OpenAI(api_key=api_key)
-        self.parse_model = "gpt-4o-mini"
-        self.text_model = "gpt-4o-mini"
-        self.transcription_model = "gpt-4o-mini-transcribe"
-        self.tts_model = "tts-1"
-
-    async def tts(
-        self,
-        text: str,
-        instructions: str = "",
-        voice: Literal["alloy", "ash", "ballad", "coral", "echo",
-                       "fable", "onyx", "nova", "sage", "shimmer"] = "nova",
-        response_format: Literal['mp3', 'opus',
-                                 'aac', 'flac', 'wav', 'pcm'] = "aac",
-    ) -> AsyncGenerator[bytes, None]:  # pragma: no cover
-        """Stream text-to-speech audio from OpenAI models.
-
-        Args:
-            text: Text to convert to speech
-            instructions: Optional instructions for speech generation
-            voice: Voice to use for synthesis
-            response_format: Audio format
-
-        Yields:
-            Audio bytes as they become available
-        """
-        try:
-            stream = self.client.audio.speech.create(
-                model=self.tts_model,
-                voice=voice,
-                input=text,
-                response_format=response_format
-            )
-
-            # Stream the bytes in chunks
-            for chunk in stream.iter_bytes(chunk_size=1024 * 16):  # 16KB chunks
-                yield chunk
-
-        except Exception as e:
-            print(f"Error in text_to_speech: {str(e)}")
-            import traceback
-            print(traceback.format_exc())
-            yield b""  # Return empty bytes on error
-
-        except Exception as e:
-            print(f"Error in text_to_speech: {str(e)}")
-            import traceback
-            print(traceback.format_exc())
-            yield f"I apologize, but I encountered an error converting text to speech: {str(e)}"
-
-    async def transcribe_audio(
-        self,
-        audio_bytes: bytes,
-        input_format: Literal[
-            "flac", "mp3", "mp4", "mpeg", "mpga", "m4a", "ogg", "wav", "webm"
-        ] = "mp4",
-    ) -> AsyncGenerator[str, None]:  # pragma: no cover
-        """Stream transcription of an audio file.
-
-        Args:
-            audio_bytes: Audio file bytes
-            input_format: Format of the input audio file
-
-        Yields:
-            Transcript text chunks as they become available
-        """
-        try:
-            stream = self.client.audio.transcriptions.create(
-                model=self.transcription_model,
-                file=(f"file.{input_format}", audio_bytes),
-                response_format="text",
-                stream=True
-            )
-
-            for event in stream:
-                if hasattr(event, 'text') and event.text:
-                    yield event.text
-
-        except Exception as e:
-            print(f"Error in transcribe_audio: {str(e)}")
-            import traceback
-            print(traceback.format_exc())
-            yield f"I apologize, but I encountered an error transcribing the audio: {str(e)}"
-
-    async def generate_text(
-        self,
-        prompt: str,
-        system_prompt: str = "",
-    ) -> AsyncGenerator[str, None]:  # pragma: no cover
-        """Generate text from OpenAI models."""
-        messages = []
-
-        if system_prompt:
-            messages.append({"role": "system", "content": system_prompt})
-
-        messages.append({"role": "user", "content": prompt})
-
-        # Prepare request parameters
-        request_params = {
-            "messages": messages,
-            "stream": True,
-            "model": self.text_model,
-        }
-        try:
-            response = self.client.chat.completions.create(**request_params)
-
-            for chunk in response:
-                if chunk.choices:
-                    if chunk.choices[0].delta.content:
-                        text = chunk.choices[0].delta.content
-                        yield text
-
-        except Exception as e:
-            print(f"Error in generate_text: {str(e)}")
-            import traceback
-            print(traceback.format_exc())
-            yield f"I apologize, but I encountered an error: {str(e)}"
-
-    async def parse_structured_output(
-        self,
-        prompt: str,
-        system_prompt: str,
-        model_class: Type[T],
-    ) -> T:  # pragma: no cover
-        """Generate structured output using Pydantic model parsing."""
-        messages = []
-        if system_prompt:
-            messages.append({"role": "system", "content": system_prompt})
-
-        messages.append({"role": "user", "content": prompt})
-
-        try:
-            # First try the beta parsing API
-            completion = self.client.beta.chat.completions.parse(
-                model=self.parse_model,
-                messages=messages,
-                response_format=model_class,
-            )
-            return completion.choices[0].message.parsed
-        except Exception as e:
-            print(f"Error with beta.parse method: {e}")

solana_agent-20.1.2.dist-info/METADATA

@@ -1,464 +0,0 @@
-Metadata-Version: 2.3
-Name: solana-agent
-Version: 20.1.2
-Summary: Agentic IQ
-License: MIT
-Keywords: ai,openai,ai agents,agi
-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: openai (>=1.68.2,<2.0.0)
-Requires-Dist: pydantic (>=2.11.1,<3.0.0)
-Requires-Dist: pymongo (>=4.11.3,<5.0.0)
-Requires-Dist: zep-cloud (>=2.8.0,<3.0.0)
-Requires-Dist: zep-python (>=2.0.2,<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
-
-# Solana Agent
-
-[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent?color=yellow)](https://pypi.org/project/solana-agent/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-orange.svg)](https://www.python.org/downloads/)
-[![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/ci.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/ci.yml)
-[![Lines of Code](https://tokei.rs/b1/github/truemagic-coder/solana-agent?type=python&category=code&style=flat)](https://github.com/truemagic-coder/solana-agent)
-
-![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
-
-## Agentic IQ
-
-Build your AI business in three lines of code!
-
-## Why?
-* Three lines of code required
-* Multi-Modal Streaming
-* Conversational Memory & History
-* Intelligent Routing
-* Business Alignment
-* Extensible Tooling
-* Simple Business Definition
-* Tested & Secure
-* Built in Python
-* Deployed by [CometHeart](https://cometheart.com) & [WalletBubbles](https://walletbubbles.com)
-
-## Features
-
-* Seamless text and audio streaming with real-time multi-modal processing
-* Persistent memory that preserves context across all agent interactions
-* Streamlined message history for all agent interactions
-* Intelligent query routing to agents with optimal domain expertise or your own custom routing
-* Unified value system ensuring brand-aligned agent responses
-* Powerful tool integration using standard Python packages and/or inline classes
-* Assigned tools are utilized by agents automatically and effectively
-* Simple business definition using JSON
-
-## Stack
-
-* [Python](https://python.org) - Programming Language
-* [OpenAI](https://openai.com) - LLMs
-* [MongoDB](https://mongodb.com) - Conversational History (optional)
-* [Zep](https://getzep.com) - Conversational Memory (optional)
-
-## Installation
-
-You can install Solana Agent using pip:
-
-`pip install solana-agent`
-
-## Usage
-
-### Business Alignment Config - Optional
-
-```python
-config = {
-    "business": {
-        "mission": "To provide users with a one-stop shop for their queries.",
-        "values": {
-            "Friendliness": "Users must be treated fairly, openly, and with friendliness.",
-            "Ethical": "Agents must use a strong ethical framework in their interactions with users.",
-        },
-        "goals": [
-            "Empower users with great answers to their queries.",
-        ],
-        "voice": "The voice of the brand is that of a research business."
-    },
-}
-```
-
-### Conversational History Config - Optional
-
-```python
-config = {
-    "mongo": {
-        "connection_string": "mongodb://localhost:27017",
-        "database": "solana_agent"
-    },
-}
-```
-
-### Conversational Memory Config - Optional
-
-```python
-config = {
-    "zep": {
-        "api_key": "your-zep-api-key",
-        "base_url": "your-zep-base-url", # not applicable if using Zep Cloud
-    },
-}
-```
-
-### Text/Text Streaming
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-async for response in solana_agent.process("user123", "What are the latest AI developments?"):
-    print(response, end="")
-```
-
-### Audio/Audio Streaming
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-audio_content = audio_file.read()
-
-async for response in solana_agent.process("user123", audio_content, output_format="audio", audio_voice="nova", audio_input_format="webm", audio_output_format="aac"):
-    print(response, end="")
-```
-
-### Text/Audio Streaming
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-async for response in solana_agent.process("user123", "What is the latest news on Elon Musk?", output_format="audio", audio_voice="nova", audio_output_format="aac"):
-    print(response, end="")
-```
-
-### Audio/Text Streaming
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-audio_content = audio_file.read()
-
-async for response in solana_agent.process("user123", audio_content, audio_input_format="aac"):
-    print(response, end="")
-```
-
-### Plugins
-
-Plugins like Solana Agent Kit (sakit) integrate automatically with Solana Agent.
-
-`pip install sakit`
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "tools": {
-        "search_internet": {
-            "api_key": "your-perplexity-key", # Required
-            "citations": True, # Optional, defaults to True
-            "model": "sonar"  # Optional, defaults to "sonar"
-        },
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-            "tools": ["search_internet"],
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-async for response in solana_agent.process("user123", "What are the latest AI developments?"):
-    print(response, end="")
-```
-
-To create a plugin like Solana Agent Kit - read the [code](https://github.com/truemagic-coder/solana-agent-kit)
-
-### Custom Inline Tools
-
-```python
-from solana_agent import SolanaAgent
-from solana_agent.interfaces.plugins.plugins import Tool
-
-class TestTool(Tool):
-    def __init__(self):
-        # your tool initialization - delete the following pass
-        pass
-
-    @property
-    def name(self) -> str:
-        return "test_function"
-
-    @property
-    def description(self) -> str:
-        return "Test function for Solana Agent"
-
-    def configure(self, config: Dict[str, Any]) -> None:
-        """Configure with all possible API key locations."""
-        super().configure(config)
-
-        # read your config values - delete the following pass
-        pass
-
-    def get_schema(self) -> Dict[str, Any]:
-        # this is an example schema
-        return {
-            "type": "object",
-            "properties": {
-                "query": {"type": "string", "description": "Search query text"},
-                "user_id": {"type": "string", "description": "User ID for the search session"}
-            },
-            "required": ["query", "user_id"]
-        }
-
-    async def execute(self, **params) -> Dict[str, Any]:
-        try:
-            # your tool logic
-            result = "Your tool results"
-
-            return {
-                "status": "success",
-                "result": result,
-            }
-        except Exception as e:
-            return {
-                "status": "error",
-                "message": f"Error: {str(e)}",
-            }
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-test_tool = TestTool()
-
-solana_agent.register_tool(test_tool)
-
-async for response in solana_agent.process("user123", "What are the latest AI developments?"):
-    print(response, end="")
-```
-
-### Custom Prompt Injection at Runtime
-
-```python
-from solana_agent import SolanaAgent
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-solana_agent = SolanaAgent(config=config)
-
-async for response in solana_agent.process("user123", "What are the latest AI developments?", "Always end your sentences with eh?"):
-    print(response, end="")
-```
-
-### Custom Routing
-
-```python
-from solana_agent import SolanaAgent
-from solana_agent.interfaces.services.routing import RoutingService as RoutingServiceInterface
-
-config = {
-    "openai": {
-        "api_key": "your-openai-api-key",
-    },
-    "agents": [
-        {
-            "name": "research_specialist",
-            "instructions": "You are an expert researcher who synthesizes complex information clearly.",
-            "specialization": "Research and knowledge synthesis",
-        },
-        {
-            "name": "customer_support",
-            "instructions": "You provide friendly, helpful customer support responses.",
-            "specialization": "Customer inquiries",
-        }
-    ],
-}
-
-class Router(RoutingServiceInterface)
-    def __init__(self):
-        # your router initialization - delete the following pass
-        pass
-
-    async def route_query(self, query: str) -> str:
-        # a simple example to route always to customer_support agent
-        return "customer_support"
-
-router = Router()
-
-solana_agent = SolanaAgent(config=config)
-
-async for response in solana_agent.process("user123", "What are the latest AI developments?", router=router):
-    print(response, end="")
-```
-
-## Notes
-* Solana Agent agents can only call one tool per response.
-* Solana Agent agents choose the best tool for the job.
-* Solana Agent tools do not use OpenAI function calling.
-* Solana Agent tools are async functions.
-
-## Local Setup
-
-A Docker Compose and Zep Config file is available at the root of this project
-
-## API Documentation
-
-The official up-to-date documentation site
-
-[Solana Agent Documentation Site](https://docs.solana-agent.com)
-
-## Official Tools
-
-The official collection of tools in one plugin
-
-[Solana Agent Kit](https://github.com/truemagic-coder/solana-agent-kit)
-
-## Example App
-
-The official example app written in FastAPI and Next.js
-
-[Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
-
-## License
-
-This project is licensed under the MIT License - see the LICENSE file for details.
-