solana-agent 22.0.8__tar.gz → 22.0.10__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.8 → solana_agent-22.0.10}/PKG-INFO +6 -110
  2. {solana_agent-22.0.8 → solana_agent-22.0.10}/README.md +5 -110
  3. {solana_agent-22.0.8 → solana_agent-22.0.10}/pyproject.toml +1 -1
  4. {solana_agent-22.0.8 → solana_agent-22.0.10}/LICENSE +0 -0
  5. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/__init__.py +0 -0
  6. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/adapters/__init__.py +0 -0
  7. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/adapters/llm_adapter.py +0 -0
  8. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/adapters/mongodb_adapter.py +0 -0
  9. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/client/__init__.py +0 -0
  10. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/client/solana_agent.py +0 -0
  11. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/domains/__init__.py +0 -0
  12. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/domains/agent.py +0 -0
  13. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/domains/routing.py +0 -0
  14. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/factories/__init__.py +0 -0
  15. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/factories/agent_factory.py +0 -0
  16. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/__init__.py +0 -0
  17. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/client/client.py +0 -0
  18. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/plugins/plugins.py +0 -0
  19. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/providers/data_storage.py +0 -0
  20. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/providers/llm.py +0 -0
  21. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/providers/memory.py +0 -0
  22. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/services/agent.py +0 -0
  23. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/services/query.py +0 -0
  24. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/interfaces/services/routing.py +0 -0
  25. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/plugins/__init__.py +0 -0
  26. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/plugins/manager.py +0 -0
  27. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/plugins/registry.py +0 -0
  28. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/plugins/tools/__init__.py +0 -0
  29. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/plugins/tools/auto_tool.py +0 -0
  30. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/repositories/__init__.py +0 -0
  31. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/repositories/memory.py +0 -0
  32. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/services/__init__.py +0 -0
  33. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/services/agent.py +0 -0
  34. {solana_agent-22.0.8 → solana_agent-22.0.10}/solana_agent/services/query.py +0 -0
  35. {solana_agent-22.0.8 → solana_agent-22.0.10}/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.8
3
+ Version: 22.0.10
4
4
  Summary: Agentic IQ
5
5
  License: MIT
6
6
  Keywords: ai,openai,ai agents,agi
@@ -60,7 +60,7 @@ Build your AI business in three lines of code!
60
60
  * Seamless text and audio streaming with real-time multi-modal processing
61
61
  * Configurable audio voice characteristics via prompting
62
62
  * Persistent memory that preserves context across all agent interactions
63
- * Quick built-in Internet search to answer your queries
63
+ * Quick built-in Internet search to answer users' queries
64
64
  * Streamlined message history for all agent interactions
65
65
  * Intelligent query routing to agents with optimal domain expertise or your own custom routing
66
66
  * Unified value system ensuring brand-aligned agent responses
@@ -487,115 +487,11 @@ The official example app written in FastAPI and Next.js
487
487
 
488
488
  [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
489
489
 
490
+ ## Agent Framework Comparisons
491
+
492
+ [Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/blob/main/compare.md)
493
+
490
494
  ## License
491
495
 
492
496
  This project is licensed under the MIT License - see the LICENSE file for details.
493
497
 
494
- ## Agent Framework Comparisons
495
-
496
- ### Solana Agent vs OpenAI Agents SDK
497
-
498
- | Feature | Solana Agent | OpenAI Agents SDK |
499
- |------------------------|-----------------------------------------------|-----------------------------------------------|
500
- | **Architecture** | Service-oriented with query routing | Agent-based with explicit handoffs |
501
- | **Configuration** | JSON-based config with minimal code | Python code-based agent definitions |
502
- | **Multi-Agent** | Automatic specialization routing | Direct agent-to-agent handoffs |
503
- | **Memory** | Integrated MongoDB/Zep persistence | In-context memory within message history |
504
- | **Multi-Modal** | Full audio/text streaming built-in | Optional voice support via add-on package |
505
- | **Model Support** | Currently OpenAI focused | Any provider with OpenAI-compatible API |
506
- | **Tool Integration** | Class-based tools with registry | Function decorators with `@function_tool` |
507
- | **Debugging** | Standard logging | Advanced tracing with visualization |
508
- | **Safety** | Basic error handling | Configurable guardrails for I/O validation |
509
- | **Output Handling** | Streaming yield pattern | Structured output types with validation |
510
- | **Business Focus** | Business mission/values framework | General purpose agent framework |
511
-
512
- ---
513
-
514
- ### Solana Agent vs LangGraph
515
-
516
- | Feature | Solana Agent | LangGraph |
517
- |------------------------|-----------------------------------------------|-----------------------------------------------|
518
- | **Architecture** | Service-oriented with agents | Graph-based state machine |
519
- | **Workflow Design** | Implicit routing by specialization | Explicit node connections and state transitions |
520
- | **Learning Curve** | Simple setup with config objects | Steeper with graph concepts and states |
521
- | **Streaming** | Native streaming for all I/O | Requires additional configuration |
522
- | **Visualization** | None built-in | Graph visualization of agent workflows |
523
- | **State Management** | Implicit state via memory | Explicit state transitions and persistence |
524
- | **Integration** | Standalone framework | Part of LangChain ecosystem |
525
- | **Flexibility** | Fixed routing paradigm | Highly customizable flow control |
526
-
527
- ---
528
-
529
- ### Solana Agent vs CrewAI
530
-
531
- | Feature | Solana Agent | CrewAI |
532
- |------------------------|-----------------------------------------------|-----------------------------------------------|
533
- | **Multi-Agent Design** | Specialist agents with router | Agent crews with explicit roles |
534
- | **Agent Interaction** | Query router determines agent | Direct agent-to-agent delegation |
535
- | **Configuration** | JSON-based configuration | Python class-based agent definitions |
536
- | **Task Structure** | Query-based interactions | Task-based with goals and workflows |
537
- | **Memory Sharing** | Shared memory store | Agent-specific memories |
538
- | **Human Interaction** | Built for direct human queries | Designed for autonomous operation |
539
- | **Streaming** | Native streaming support | Limited streaming support |
540
- | **Team Dynamics** | Flat specialist structure | Hierarchical with managers and workers |
541
-
542
- ---
543
-
544
- ### Solana Agent vs PydanticAI
545
-
546
- | Feature | Solana Agent | PydanticAI |
547
- |------------------------|-----------------------------------------------|---------------------------------------------|
548
- | **Multi-Modal** | Full audio/text streaming built-in | Text output only, input depends on LLM |
549
- | **Memory** | Built-in conversation history | Not included |
550
- | **Multi-Agent** | First-class multi-agent support | Single agent focus with composition patterns|
551
- | **Tool Creation** | Python classes with execute method | Function decorators with schema |
552
- | **Model Support** | Currently OpenAI focused | Integrates with many LLMs |
553
- | **Debugging** | Standard logging | Pydantic Logfire integration |
554
- | **Flow Control** | Implicit routing | Python control flow with graph support |
555
-
556
- ---
557
-
558
- ### When to Use Each Framework
559
-
560
- #### Choose **Solana Agent** when:
561
- - You need a simple, quick-to-deploy agent system.
562
- - Multi-modal support (text/audio) is essential.
563
- - You want automatic routing between specialized agents.
564
- - Business mission alignment is important.
565
- - You prefer configuration over code.
566
- - Persistent memory across conversations is needed.
567
- - You want streaming responses out of the box.
568
-
569
- #### Choose **OpenAI Agents SDK** when:
570
- - You need detailed tracing for debugging complex agent workflows.
571
- - You want explicit control over agent handoffs.
572
- - Your architecture requires structured output validation.
573
- - You're using multiple LLM providers with OpenAI-compatible APIs.
574
- - You need configurable guardrails for safety.
575
- - You prefer a code-first approach to agent definition.
576
-
577
- #### Choose **LangGraph** when:
578
- - You need complex, multi-step workflows with branching logic.
579
- - Your use case requires explicit state management.
580
- - You want to visualize the flow of your agent system.
581
- - You're already in the LangChain ecosystem.
582
- - You need fine-grained control over agent decision paths.
583
- - Your application has complex conditional flows.
584
- - You want to model your agent system as a state machine.
585
-
586
- #### Choose **CrewAI** when:
587
- - You need agents to work together with minimal human input.
588
- - Your use case involves complex team collaboration.
589
- - You need hierarchical task delegation between agents.
590
- - You want agents with specific roles and responsibilities.
591
- - Your application requires autonomous operation.
592
- - You need explicit agent-to-agent communication.
593
- - Your workflow involves complex multi-step tasks.
594
-
595
- #### Choose **PydanticAI** when:
596
- - You want to use multiple LLM providers in one codebase.
597
- - You need real-time debugging and monitoring of agent behavior.
598
- - You require structured responses with validation guarantees.
599
- - Your application needs dependency injection for easier testing.
600
- - You want to leverage your existing Pydantic knowledge.
601
- - You need both simple control flow and complex graph capabilities.
@@ -36,7 +36,7 @@ Build your AI business in three lines of code!
36
36
  * Seamless text and audio streaming with real-time multi-modal processing
37
37
  * Configurable audio voice characteristics via prompting
38
38
  * Persistent memory that preserves context across all agent interactions
39
- * Quick built-in Internet search to answer your queries
39
+ * Quick built-in Internet search to answer users' queries
40
40
  * Streamlined message history for all agent interactions
41
41
  * Intelligent query routing to agents with optimal domain expertise or your own custom routing
42
42
  * Unified value system ensuring brand-aligned agent responses
@@ -463,115 +463,10 @@ The official example app written in FastAPI and Next.js
463
463
 
464
464
  [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
465
465
 
466
- ## License
466
+ ## Agent Framework Comparisons
467
467
 
468
- This project is licensed under the MIT License - see the LICENSE file for details.
468
+ [Compare Python Agent Frameworks](https://github.com/truemagic-coder/solana-agent/blob/main/compare.md)
469
469
 
470
- ## Agent Framework Comparisons
470
+ ## License
471
471
 
472
- ### Solana Agent vs OpenAI Agents SDK
473
-
474
- | Feature | Solana Agent | OpenAI Agents SDK |
475
- |------------------------|-----------------------------------------------|-----------------------------------------------|
476
- | **Architecture** | Service-oriented with query routing | Agent-based with explicit handoffs |
477
- | **Configuration** | JSON-based config with minimal code | Python code-based agent definitions |
478
- | **Multi-Agent** | Automatic specialization routing | Direct agent-to-agent handoffs |
479
- | **Memory** | Integrated MongoDB/Zep persistence | In-context memory within message history |
480
- | **Multi-Modal** | Full audio/text streaming built-in | Optional voice support via add-on package |
481
- | **Model Support** | Currently OpenAI focused | Any provider with OpenAI-compatible API |
482
- | **Tool Integration** | Class-based tools with registry | Function decorators with `@function_tool` |
483
- | **Debugging** | Standard logging | Advanced tracing with visualization |
484
- | **Safety** | Basic error handling | Configurable guardrails for I/O validation |
485
- | **Output Handling** | Streaming yield pattern | Structured output types with validation |
486
- | **Business Focus** | Business mission/values framework | General purpose agent framework |
487
-
488
- ---
489
-
490
- ### Solana Agent vs LangGraph
491
-
492
- | Feature | Solana Agent | LangGraph |
493
- |------------------------|-----------------------------------------------|-----------------------------------------------|
494
- | **Architecture** | Service-oriented with agents | Graph-based state machine |
495
- | **Workflow Design** | Implicit routing by specialization | Explicit node connections and state transitions |
496
- | **Learning Curve** | Simple setup with config objects | Steeper with graph concepts and states |
497
- | **Streaming** | Native streaming for all I/O | Requires additional configuration |
498
- | **Visualization** | None built-in | Graph visualization of agent workflows |
499
- | **State Management** | Implicit state via memory | Explicit state transitions and persistence |
500
- | **Integration** | Standalone framework | Part of LangChain ecosystem |
501
- | **Flexibility** | Fixed routing paradigm | Highly customizable flow control |
502
-
503
- ---
504
-
505
- ### Solana Agent vs CrewAI
506
-
507
- | Feature | Solana Agent | CrewAI |
508
- |------------------------|-----------------------------------------------|-----------------------------------------------|
509
- | **Multi-Agent Design** | Specialist agents with router | Agent crews with explicit roles |
510
- | **Agent Interaction** | Query router determines agent | Direct agent-to-agent delegation |
511
- | **Configuration** | JSON-based configuration | Python class-based agent definitions |
512
- | **Task Structure** | Query-based interactions | Task-based with goals and workflows |
513
- | **Memory Sharing** | Shared memory store | Agent-specific memories |
514
- | **Human Interaction** | Built for direct human queries | Designed for autonomous operation |
515
- | **Streaming** | Native streaming support | Limited streaming support |
516
- | **Team Dynamics** | Flat specialist structure | Hierarchical with managers and workers |
517
-
518
- ---
519
-
520
- ### Solana Agent vs PydanticAI
521
-
522
- | Feature | Solana Agent | PydanticAI |
523
- |------------------------|-----------------------------------------------|---------------------------------------------|
524
- | **Multi-Modal** | Full audio/text streaming built-in | Text output only, input depends on LLM |
525
- | **Memory** | Built-in conversation history | Not included |
526
- | **Multi-Agent** | First-class multi-agent support | Single agent focus with composition patterns|
527
- | **Tool Creation** | Python classes with execute method | Function decorators with schema |
528
- | **Model Support** | Currently OpenAI focused | Integrates with many LLMs |
529
- | **Debugging** | Standard logging | Pydantic Logfire integration |
530
- | **Flow Control** | Implicit routing | Python control flow with graph support |
531
-
532
- ---
533
-
534
- ### When to Use Each Framework
535
-
536
- #### Choose **Solana Agent** when:
537
- - You need a simple, quick-to-deploy agent system.
538
- - Multi-modal support (text/audio) is essential.
539
- - You want automatic routing between specialized agents.
540
- - Business mission alignment is important.
541
- - You prefer configuration over code.
542
- - Persistent memory across conversations is needed.
543
- - You want streaming responses out of the box.
544
-
545
- #### Choose **OpenAI Agents SDK** when:
546
- - You need detailed tracing for debugging complex agent workflows.
547
- - You want explicit control over agent handoffs.
548
- - Your architecture requires structured output validation.
549
- - You're using multiple LLM providers with OpenAI-compatible APIs.
550
- - You need configurable guardrails for safety.
551
- - You prefer a code-first approach to agent definition.
552
-
553
- #### Choose **LangGraph** when:
554
- - You need complex, multi-step workflows with branching logic.
555
- - Your use case requires explicit state management.
556
- - You want to visualize the flow of your agent system.
557
- - You're already in the LangChain ecosystem.
558
- - You need fine-grained control over agent decision paths.
559
- - Your application has complex conditional flows.
560
- - You want to model your agent system as a state machine.
561
-
562
- #### Choose **CrewAI** when:
563
- - You need agents to work together with minimal human input.
564
- - Your use case involves complex team collaboration.
565
- - You need hierarchical task delegation between agents.
566
- - You want agents with specific roles and responsibilities.
567
- - Your application requires autonomous operation.
568
- - You need explicit agent-to-agent communication.
569
- - Your workflow involves complex multi-step tasks.
570
-
571
- #### Choose **PydanticAI** when:
572
- - You want to use multiple LLM providers in one codebase.
573
- - You need real-time debugging and monitoring of agent behavior.
574
- - You require structured responses with validation guarantees.
575
- - Your application needs dependency injection for easier testing.
576
- - You want to leverage your existing Pydantic knowledge.
577
- - You need both simple control flow and complex graph capabilities.
472
+ This project is licensed under the MIT License - see the LICENSE file for details.
@@ -1,6 +1,6 @@
1
1
  [tool.poetry]
2
2
  name = "solana-agent"
3
- version = "22.0.8"
3
+ version = "22.0.10"
4
4
  description = "Agentic IQ"
5
5
  authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
6
6
  license = "MIT"
File without changes