solana-agent 22.0.5__tar.gz → 22.0.7__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. {solana_agent-22.0.5 → solana_agent-22.0.7}/PKG-INFO +30 -26
  2. {solana_agent-22.0.5 → solana_agent-22.0.7}/README.md +29 -25
  3. {solana_agent-22.0.5 → solana_agent-22.0.7}/pyproject.toml +1 -1
  4. {solana_agent-22.0.5 → solana_agent-22.0.7}/LICENSE +0 -0
  5. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/__init__.py +0 -0
  6. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/adapters/__init__.py +0 -0
  7. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/adapters/llm_adapter.py +0 -0
  8. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/adapters/mongodb_adapter.py +0 -0
  9. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/client/__init__.py +0 -0
  10. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/client/solana_agent.py +0 -0
  11. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/domains/__init__.py +0 -0
  12. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/domains/agent.py +0 -0
  13. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/domains/routing.py +0 -0
  14. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/factories/__init__.py +0 -0
  15. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/factories/agent_factory.py +0 -0
  16. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/__init__.py +0 -0
  17. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/client/client.py +0 -0
  18. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/plugins/plugins.py +0 -0
  19. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/providers/data_storage.py +0 -0
  20. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/providers/llm.py +0 -0
  21. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/providers/memory.py +0 -0
  22. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/services/agent.py +0 -0
  23. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/services/query.py +0 -0
  24. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/interfaces/services/routing.py +0 -0
  25. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/plugins/__init__.py +0 -0
  26. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/plugins/manager.py +0 -0
  27. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/plugins/registry.py +0 -0
  28. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/plugins/tools/__init__.py +0 -0
  29. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/plugins/tools/auto_tool.py +0 -0
  30. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/repositories/__init__.py +0 -0
  31. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/repositories/memory.py +0 -0
  32. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/services/__init__.py +0 -0
  33. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/services/agent.py +0 -0
  34. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/services/query.py +0 -0
  35. {solana_agent-22.0.5 → solana_agent-22.0.7}/solana_agent/services/routing.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: solana-agent
3
- Version: 22.0.5
3
+ Version: 22.0.7
4
4
  Summary: Agentic IQ
5
5
  License: MIT
6
6
  Keywords: ai,openai,ai agents,agi
@@ -25,12 +25,13 @@ Description-Content-Type: text/markdown
25
25
  # Solana Agent
26
26
 
27
27
  [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
28
- [![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent?color=yellow)](https://pypi.org/project/solana-agent/)
28
+ [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
29
+ [![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent)](https://pypi.org/project/solana-agent/)
29
30
  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
30
- [![Python 3.12+](https://img.shields.io/badge/python-3.12+-orange.svg)](https://www.python.org/downloads/)
31
31
  [![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
32
32
  [![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)
33
33
  [![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)
34
+ [![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/truemagic-coder/solana-agent)](https://libraries.io/pypi/solana-agent)
34
35
 
35
36
  ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
36
37
 
@@ -41,7 +42,7 @@ Build your AI business in three lines of code!
41
42
  ## Why?
42
43
  * Three lines of code setup
43
44
  * Multi-Agent Swarm
44
- * Multi-Modal Streaming
45
+ * Multi-Modal Streaming (Text & Audio)
45
46
  * Conversational Memory & History
46
47
  * Built-in Internet Search
47
48
  * Intelligent Routing
@@ -50,15 +51,16 @@ Build your AI business in three lines of code!
50
51
  * Simple Business Definition
51
52
  * Tested & Secure
52
53
  * Built in Python
53
- * Deployed by [CometHeart](https://cometheart.com) & [WalletBubbles](https://walletbubbles.com)
54
+ * Powers [CometHeart](https://cometheart.com) & [WalletBubbles](https://walletbubbles.com)
54
55
 
55
56
  ## Features
56
57
 
57
58
  * Easy three lines of code setup
58
59
  * Designed for a multi-agent swarm
59
60
  * Seamless text and audio streaming with real-time multi-modal processing
61
+ * Configurable audio voice characteristics via prompting
60
62
  * Persistent memory that preserves context across all agent interactions
61
- * Quick built-in Internet Search to answer your queries
63
+ * Quick built-in Internet search to answer your queries
62
64
  * Streamlined message history for all agent interactions
63
65
  * Intelligent query routing to agents with optimal domain expertise or your own custom routing
64
66
  * Unified value system ensuring brand-aligned agent responses
@@ -249,10 +251,20 @@ async for response in solana_agent.process("user123", "Write me a poem.", intern
249
251
  print(response, end="")
250
252
  ```
251
253
 
252
- ### Customize Audio Voice
254
+ ### Customize Speech
253
255
 
254
256
  This is an audio to audio example using the `audio_instructions` parameter.
255
257
 
258
+ You can prompt to control aspects of speech, including:
259
+
260
+ * Accent
261
+ * Emotional range
262
+ * Intonation
263
+ * Impressions
264
+ * Speed of speech
265
+ * Tone
266
+ * Whispering
267
+
256
268
  ```python
257
269
  async for response in solana_agent.process("user123", audio_content, output_format="audio", audio_voice="nova", audio_input_format="webm", audio_output_format="aac", audio_instructions="You speak with an American southern accent"):
258
270
  print(response, end="")
@@ -262,7 +274,12 @@ async for response in solana_agent.process("user123", audio_content, output_form
262
274
 
263
275
  Tools can be used from plugins like Solana Agent Kit (sakit) or via custom inline tools. Tools available via plugins integrate automatically with Solana Agent.
264
276
 
265
- ### Plugin Usage Example
277
+ * Agents can only call one tool per response
278
+ * Agents choose the best tool for the job
279
+ * Tools do not use OpenAI function calling
280
+ * Tools are async functions
281
+
282
+ ### Tool Example
266
283
 
267
284
  `pip install sakit`
268
285
 
@@ -379,11 +396,13 @@ async for response in solana_agent.process("user123", "What are the latest AI de
379
396
  print(response, end="")
380
397
  ```
381
398
 
382
- ## Training your Agents
399
+ ## Agent Training
383
400
 
384
401
  Many use-cases for Solana Agent require training your agents on your company data.
385
402
 
386
- This can be accomplished via runtime prompt injection. Integrations that work well with this method are KBs like Pinecone and FAQs.
403
+ This can be accomplished via runtime prompt injection. Integrations that work well with this method are vector stores like Pinecone and FAQs.
404
+
405
+ This knowledge applies to all your AI agents.
387
406
 
388
407
  ```python
389
408
  from solana_agent import SolanaAgent
@@ -393,11 +412,6 @@ config = {
393
412
  "api_key": "your-openai-api-key",
394
413
  },
395
414
  "agents": [
396
- {
397
- "name": "research_specialist",
398
- "instructions": "You are an expert researcher who synthesizes complex information clearly.",
399
- "specialization": "Research and knowledge synthesis",
400
- },
401
415
  {
402
416
  "name": "customer_support",
403
417
  "instructions": "You provide friendly, helpful customer support responses.",
@@ -408,7 +422,7 @@ config = {
408
422
 
409
423
  solana_agent = SolanaAgent(config=config)
410
424
 
411
- async for response in solana_agent.process("user123", "What are the latest AI developments?", "This is my FAQ"):
425
+ async for response in solana_agent.process("user123", "How do replace the latch on my dishwasher?", "This is my corporate appliance fixing FAQ"):
412
426
  print(response, end="")
413
427
  ```
414
428
 
@@ -455,16 +469,6 @@ async for response in solana_agent.process("user123", "What are the latest AI de
455
469
  print(response, end="")
456
470
  ```
457
471
 
458
- ## Notes
459
- * Solana Agent agents can only call one tool per response.
460
- * Solana Agent agents choose the best tool for the job.
461
- * Solana Agent tools do not use OpenAI function calling.
462
- * Solana Agent tools are async functions.
463
-
464
- ## Local Setup
465
-
466
- A Docker Compose and Zep Config file is available at the root of this project
467
-
468
472
  ## API Documentation
469
473
 
470
474
  The official up-to-date documentation site
@@ -1,12 +1,13 @@
1
1
  # Solana Agent
2
2
 
3
3
  [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
4
- [![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent?color=yellow)](https://pypi.org/project/solana-agent/)
4
+ [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
5
+ [![PyPI - Downloads](https://img.shields.io/pypi/dm/solana-agent)](https://pypi.org/project/solana-agent/)
5
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
6
- [![Python 3.12+](https://img.shields.io/badge/python-3.12+-orange.svg)](https://www.python.org/downloads/)
7
7
  [![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
8
8
  [![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)
9
9
  [![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)
10
+ [![Libraries.io dependency status for GitHub repo](https://img.shields.io/librariesio/github/truemagic-coder/solana-agent)](https://libraries.io/pypi/solana-agent)
10
11
 
11
12
  ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
12
13
 
@@ -17,7 +18,7 @@ Build your AI business in three lines of code!
17
18
  ## Why?
18
19
  * Three lines of code setup
19
20
  * Multi-Agent Swarm
20
- * Multi-Modal Streaming
21
+ * Multi-Modal Streaming (Text & Audio)
21
22
  * Conversational Memory & History
22
23
  * Built-in Internet Search
23
24
  * Intelligent Routing
@@ -26,15 +27,16 @@ Build your AI business in three lines of code!
26
27
  * Simple Business Definition
27
28
  * Tested & Secure
28
29
  * Built in Python
29
- * Deployed by [CometHeart](https://cometheart.com) & [WalletBubbles](https://walletbubbles.com)
30
+ * Powers [CometHeart](https://cometheart.com) & [WalletBubbles](https://walletbubbles.com)
30
31
 
31
32
  ## Features
32
33
 
33
34
  * Easy three lines of code setup
34
35
  * Designed for a multi-agent swarm
35
36
  * Seamless text and audio streaming with real-time multi-modal processing
37
+ * Configurable audio voice characteristics via prompting
36
38
  * Persistent memory that preserves context across all agent interactions
37
- * Quick built-in Internet Search to answer your queries
39
+ * Quick built-in Internet search to answer your queries
38
40
  * Streamlined message history for all agent interactions
39
41
  * Intelligent query routing to agents with optimal domain expertise or your own custom routing
40
42
  * Unified value system ensuring brand-aligned agent responses
@@ -225,10 +227,20 @@ async for response in solana_agent.process("user123", "Write me a poem.", intern
225
227
  print(response, end="")
226
228
  ```
227
229
 
228
- ### Customize Audio Voice
230
+ ### Customize Speech
229
231
 
230
232
  This is an audio to audio example using the `audio_instructions` parameter.
231
233
 
234
+ You can prompt to control aspects of speech, including:
235
+
236
+ * Accent
237
+ * Emotional range
238
+ * Intonation
239
+ * Impressions
240
+ * Speed of speech
241
+ * Tone
242
+ * Whispering
243
+
232
244
  ```python
233
245
  async for response in solana_agent.process("user123", audio_content, output_format="audio", audio_voice="nova", audio_input_format="webm", audio_output_format="aac", audio_instructions="You speak with an American southern accent"):
234
246
  print(response, end="")
@@ -238,7 +250,12 @@ async for response in solana_agent.process("user123", audio_content, output_form
238
250
 
239
251
  Tools can be used from plugins like Solana Agent Kit (sakit) or via custom inline tools. Tools available via plugins integrate automatically with Solana Agent.
240
252
 
241
- ### Plugin Usage Example
253
+ * Agents can only call one tool per response
254
+ * Agents choose the best tool for the job
255
+ * Tools do not use OpenAI function calling
256
+ * Tools are async functions
257
+
258
+ ### Tool Example
242
259
 
243
260
  `pip install sakit`
244
261
 
@@ -355,11 +372,13 @@ async for response in solana_agent.process("user123", "What are the latest AI de
355
372
  print(response, end="")
356
373
  ```
357
374
 
358
- ## Training your Agents
375
+ ## Agent Training
359
376
 
360
377
  Many use-cases for Solana Agent require training your agents on your company data.
361
378
 
362
- This can be accomplished via runtime prompt injection. Integrations that work well with this method are KBs like Pinecone and FAQs.
379
+ This can be accomplished via runtime prompt injection. Integrations that work well with this method are vector stores like Pinecone and FAQs.
380
+
381
+ This knowledge applies to all your AI agents.
363
382
 
364
383
  ```python
365
384
  from solana_agent import SolanaAgent
@@ -369,11 +388,6 @@ config = {
369
388
  "api_key": "your-openai-api-key",
370
389
  },
371
390
  "agents": [
372
- {
373
- "name": "research_specialist",
374
- "instructions": "You are an expert researcher who synthesizes complex information clearly.",
375
- "specialization": "Research and knowledge synthesis",
376
- },
377
391
  {
378
392
  "name": "customer_support",
379
393
  "instructions": "You provide friendly, helpful customer support responses.",
@@ -384,7 +398,7 @@ config = {
384
398
 
385
399
  solana_agent = SolanaAgent(config=config)
386
400
 
387
- async for response in solana_agent.process("user123", "What are the latest AI developments?", "This is my FAQ"):
401
+ async for response in solana_agent.process("user123", "How do replace the latch on my dishwasher?", "This is my corporate appliance fixing FAQ"):
388
402
  print(response, end="")
389
403
  ```
390
404
 
@@ -431,16 +445,6 @@ async for response in solana_agent.process("user123", "What are the latest AI de
431
445
  print(response, end="")
432
446
  ```
433
447
 
434
- ## Notes
435
- * Solana Agent agents can only call one tool per response.
436
- * Solana Agent agents choose the best tool for the job.
437
- * Solana Agent tools do not use OpenAI function calling.
438
- * Solana Agent tools are async functions.
439
-
440
- ## Local Setup
441
-
442
- A Docker Compose and Zep Config file is available at the root of this project
443
-
444
448
  ## API Documentation
445
449
 
446
450
  The official up-to-date documentation site
@@ -1,6 +1,6 @@
1
1
  [tool.poetry]
2
2
  name = "solana-agent"
3
- version = "22.0.5"
3
+ version = "22.0.7"
4
4
  description = "Agentic IQ"
5
5
  authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
6
6
  license = "MIT"
File without changes