solana-agent 6.0.0__tar.gz → 7.0.0__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.
@@ -0,0 +1,178 @@
1
+ Metadata-Version: 2.3
2
+ Name: solana-agent
3
+ Version: 7.0.0
4
+ Summary: The first AGI framework
5
+ License: MIT
6
+ Keywords: ai,openai,ai agents,agi
7
+ Author: Bevan Hunt
8
+ Author-email: bevan@bevanhunt.com
9
+ Requires-Python: >=3.9,<4.0
10
+ Classifier: License :: OSI Approved :: MIT License
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Programming Language :: Python :: 3.9
13
+ Classifier: Programming Language :: Python :: 3.10
14
+ Classifier: Programming Language :: Python :: 3.11
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Programming Language :: Python :: 3.13
17
+ Classifier: Programming Language :: Python :: 3 :: Only
18
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
19
+ Requires-Dist: ntplib (>=0.4.0,<0.5.0)
20
+ Requires-Dist: openai (>=1.65.2,<2.0.0)
21
+ Requires-Dist: pandas (>=2.2.3,<3.0.0)
22
+ Requires-Dist: pinecone (>=6.0.1,<7.0.0)
23
+ Requires-Dist: pydantic (>=2.10.6,<3.0.0)
24
+ Requires-Dist: pymongo (>=4.11.1,<5.0.0)
25
+ Requires-Dist: requests (>=2.32.3,<3.0.0)
26
+ Requires-Dist: zep-cloud (>=2.4.0,<3.0.0)
27
+ Requires-Dist: zep-python (>=2.0.2,<3.0.0)
28
+ Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
29
+ Description-Content-Type: text/markdown
30
+
31
+ # Solana Agent
32
+
33
+ [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
34
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
35
+ [![Python 3.9+](https://img.shields.io/badge/python-3.9+-orange.svg)](https://www.python.org/downloads/)
36
+
37
+ ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
38
+
39
+ ## Why Solana Agent?
40
+
41
+ ### The First AGI Framework
42
+
43
+ Solana Agent transforms AI from isolated conversations into a continuously evolving intelligence network powered by specialized agents that learn, remember, and grow smarter together.
44
+
45
+ **Why This Matters for AGI:**
46
+
47
+ - 🧠 **Emergent Intelligence:** Specialized agents form a neural network-like system where the whole exceeds the sum of its parts
48
+ - 🔄 **Autonomous Self-Improvement:** Critic system analyzes responses, identifies weaknesses, and autonomously researches to fill knowledge gaps
49
+ - 📈 **Exponential Learning:** Each interaction improves future responses through continuous feedback loops and pattern recognition
50
+ - 🌐 **Distributed Cognition:** Problems are decomposed across specialized cognitive modules, mirroring human brain specialization
51
+ - 🧩 **Knowledge Integration:** Synthesizes information across domains to form novel connections and insights
52
+ - 🛠️ **Adaptive Problem-Solving**: Dynamically reconfigures approach based on task complexity and previous solution efficacy
53
+
54
+ ## Features
55
+
56
+ ### 🗣️ **Advanced Interaction Layer**
57
+ - Streaming text-based conversations with real-time thinking
58
+ - Voice-to-voice conversations with natural cadence
59
+ - Multi-turn context preservation and reasoning
60
+
61
+ ### 🤖 **Multi-Agent Swarm Architecture**
62
+ - Dynamic specialized agent creation and coordination
63
+ - Intelligent routing based on query content and agent expertise
64
+ - Seamless handoffs with comprehensive context passing
65
+ - Parallel processing capabilities for complex multi-part questions
66
+ - Shared memory and collective intelligence across the entire swarm
67
+
68
+ ### 🔍 **Multi-Source Knowledge Integration**
69
+ - Real-time internet search via Perplexity API
70
+ - Social media monitoring via X/Twitter (Grok API)
71
+ - Long-term conversational memory with Zep's graph-based storage
72
+ - Structured data analysis with CSV processing and summarization
73
+ - Vector-based knowledge retrieval with semantic search via Pinecone
74
+ - Hybrid search combining vector similarity and text relevance via MongoDB and Pinecone
75
+
76
+ ### 🌐 **Collective Swarm Intelligence**
77
+ - Hybrid semantic-keyword search spanning all user interactions
78
+ - Privacy-preserving knowledge extraction from conversations
79
+ - Self-organizing knowledge base with automatic categorization
80
+ - Cross-domain insight discovery and connection building
81
+ - Autonomous knowledge refinement through verification tasks
82
+
83
+ ### 🕰️ **Time-Aware Intelligence**
84
+ - User-specific timezone handling for personalized time references
85
+ - Chronologically accurate responses across all conversations
86
+ - Default timezone fallbacks at both agent and swarm levels
87
+ - Seamless timezone preservation during agent handoffs
88
+
89
+ ### ⚖️ **Self-Critical System**
90
+ - AI critic that evaluates agent responses for quality and accuracy
91
+ - Autonomous identification of improvement areas across all agents
92
+ - Prioritized feedback based on severity and impact
93
+ - System-wide trend analysis to track collective improvement
94
+ - Integrates feedback automatically to improve future answers
95
+
96
+ ### 🎯 **Unified Mission Framework**
97
+ - Define organization-wide values, goals, and operating principles
98
+ - Automatically applied to all agents in the swarm
99
+ - Visually distinct formatting for clarity and emphasis
100
+ - Consistent decision-making aligned with organizational priorities
101
+ - Individual agent specializations work within the directive framework
102
+
103
+ ## Privacy and Collective Memory
104
+
105
+ Solana Agent's collective memory system is designed with privacy in mind:
106
+
107
+ - **Selective Knowledge Extraction**: Only factual, non-personal information is extracted
108
+ - **Privacy Filtering**: The AI is instructed to exclude user-specific details, opinions, and sensitive information
109
+ - **Optional Feature**: Easily disable collective memory with the `enable_collective_memory=False` parameter
110
+ - **Transparency**: Extracted insights are accessible and reviewable
111
+ - **Customizable Thresholds**: Adjust what qualifies as a valuable insight worth sharing
112
+
113
+ When collective memory is enabled, the system extracts valuable factual knowledge that can benefit all users, while carefully avoiding personal or sensitive information. For environments with stricter privacy requirements, the feature can be completely disabled.
114
+
115
+ ## Time Awareness
116
+
117
+ Solana Agent's time awareness system ensures your AI assistants always provide chronologically accurate responses based on each user's timezone:
118
+
119
+ - **User-Based Time Context**: Pass user timezone directly in conversation requests
120
+ - **Global Time Management**: Get precise time in any timezone using NTP synchronization
121
+ - **Timezone Preservation**: Maintains timezone context during agent handoffs
122
+ - **Default Fallbacks**: Configurable defaults at both agent and swarm levels
123
+ - **Contextual Date Awareness**: All agents understand "today," "next week," or "in 3 days" relative to user's timezone
124
+
125
+ ## Why Choose Solana Agent Over LangChain?
126
+
127
+ ### 🎯 Key Differentiators
128
+
129
+ #### 💡 **AGI-First Architecture**
130
+ - Designed for autonomous intelligence and self-improvement
131
+ - Framework for agents to improve themselves without human intervention
132
+
133
+ #### 🧠 **Advanced Memory Architecture**
134
+ - Sophisticated episodic and semantic memory vs. basic memory types
135
+ - Cross-session knowledge retention with importance-based storage
136
+ - Autonomous extraction of insights from conversations
137
+ - Collective memory across users and agents
138
+
139
+ #### 🤝 **True Multi-Agent Orchestration**
140
+ - First-class swarm intelligence with specialized agent teams
141
+ - Dynamic routing based on expertise and query complexity
142
+ - Seamless context preservation during handoffs
143
+ - Single unified interface for the entire agent ecosystem
144
+ - Unified mission framework for consistent decision making
145
+
146
+ #### 🏢 **Enterprise Production Readiness**
147
+ - Deployment-ready with minimal configuration
148
+ - Comprehensive error handling and recovery mechanisms
149
+ - Scalable architecture supporting high-concurrency environments
150
+ - Privacy-preserving design with configurable controls
151
+
152
+ #### 🛠️ **Developer Experience**
153
+ - Clean, intuitive API without excessive abstractions
154
+ - Standard Python functions vs complex chaining constructs
155
+ - Minimal boilerplate for common operations
156
+ - ~1500 vs ~500,000 lines of code
157
+
158
+ ## Installation
159
+
160
+ You can install Solana Agent using pip:
161
+
162
+ ```bash
163
+ pip install solana-agent
164
+ ```
165
+
166
+ ## Documentation
167
+ * Each public method has a docstring for real-time IDE hinting
168
+
169
+ ## Production Apps
170
+ * [CometHeart](https://cometheart.com) - AI Companion and Business Coach on mobile using voice-to-voice conversations
171
+
172
+ ## Example Apps
173
+ * [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app) - See as source of documentation
174
+
175
+ ## License
176
+
177
+ This project is licensed under the MIT License - see the LICENSE file for details.
178
+
@@ -0,0 +1,147 @@
1
+ # Solana Agent
2
+
3
+ [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
5
+ [![Python 3.9+](https://img.shields.io/badge/python-3.9+-orange.svg)](https://www.python.org/downloads/)
6
+
7
+ ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
8
+
9
+ ## Why Solana Agent?
10
+
11
+ ### The First AGI Framework
12
+
13
+ Solana Agent transforms AI from isolated conversations into a continuously evolving intelligence network powered by specialized agents that learn, remember, and grow smarter together.
14
+
15
+ **Why This Matters for AGI:**
16
+
17
+ - 🧠 **Emergent Intelligence:** Specialized agents form a neural network-like system where the whole exceeds the sum of its parts
18
+ - 🔄 **Autonomous Self-Improvement:** Critic system analyzes responses, identifies weaknesses, and autonomously researches to fill knowledge gaps
19
+ - 📈 **Exponential Learning:** Each interaction improves future responses through continuous feedback loops and pattern recognition
20
+ - 🌐 **Distributed Cognition:** Problems are decomposed across specialized cognitive modules, mirroring human brain specialization
21
+ - 🧩 **Knowledge Integration:** Synthesizes information across domains to form novel connections and insights
22
+ - 🛠️ **Adaptive Problem-Solving**: Dynamically reconfigures approach based on task complexity and previous solution efficacy
23
+
24
+ ## Features
25
+
26
+ ### 🗣️ **Advanced Interaction Layer**
27
+ - Streaming text-based conversations with real-time thinking
28
+ - Voice-to-voice conversations with natural cadence
29
+ - Multi-turn context preservation and reasoning
30
+
31
+ ### 🤖 **Multi-Agent Swarm Architecture**
32
+ - Dynamic specialized agent creation and coordination
33
+ - Intelligent routing based on query content and agent expertise
34
+ - Seamless handoffs with comprehensive context passing
35
+ - Parallel processing capabilities for complex multi-part questions
36
+ - Shared memory and collective intelligence across the entire swarm
37
+
38
+ ### 🔍 **Multi-Source Knowledge Integration**
39
+ - Real-time internet search via Perplexity API
40
+ - Social media monitoring via X/Twitter (Grok API)
41
+ - Long-term conversational memory with Zep's graph-based storage
42
+ - Structured data analysis with CSV processing and summarization
43
+ - Vector-based knowledge retrieval with semantic search via Pinecone
44
+ - Hybrid search combining vector similarity and text relevance via MongoDB and Pinecone
45
+
46
+ ### 🌐 **Collective Swarm Intelligence**
47
+ - Hybrid semantic-keyword search spanning all user interactions
48
+ - Privacy-preserving knowledge extraction from conversations
49
+ - Self-organizing knowledge base with automatic categorization
50
+ - Cross-domain insight discovery and connection building
51
+ - Autonomous knowledge refinement through verification tasks
52
+
53
+ ### 🕰️ **Time-Aware Intelligence**
54
+ - User-specific timezone handling for personalized time references
55
+ - Chronologically accurate responses across all conversations
56
+ - Default timezone fallbacks at both agent and swarm levels
57
+ - Seamless timezone preservation during agent handoffs
58
+
59
+ ### ⚖️ **Self-Critical System**
60
+ - AI critic that evaluates agent responses for quality and accuracy
61
+ - Autonomous identification of improvement areas across all agents
62
+ - Prioritized feedback based on severity and impact
63
+ - System-wide trend analysis to track collective improvement
64
+ - Integrates feedback automatically to improve future answers
65
+
66
+ ### 🎯 **Unified Mission Framework**
67
+ - Define organization-wide values, goals, and operating principles
68
+ - Automatically applied to all agents in the swarm
69
+ - Visually distinct formatting for clarity and emphasis
70
+ - Consistent decision-making aligned with organizational priorities
71
+ - Individual agent specializations work within the directive framework
72
+
73
+ ## Privacy and Collective Memory
74
+
75
+ Solana Agent's collective memory system is designed with privacy in mind:
76
+
77
+ - **Selective Knowledge Extraction**: Only factual, non-personal information is extracted
78
+ - **Privacy Filtering**: The AI is instructed to exclude user-specific details, opinions, and sensitive information
79
+ - **Optional Feature**: Easily disable collective memory with the `enable_collective_memory=False` parameter
80
+ - **Transparency**: Extracted insights are accessible and reviewable
81
+ - **Customizable Thresholds**: Adjust what qualifies as a valuable insight worth sharing
82
+
83
+ When collective memory is enabled, the system extracts valuable factual knowledge that can benefit all users, while carefully avoiding personal or sensitive information. For environments with stricter privacy requirements, the feature can be completely disabled.
84
+
85
+ ## Time Awareness
86
+
87
+ Solana Agent's time awareness system ensures your AI assistants always provide chronologically accurate responses based on each user's timezone:
88
+
89
+ - **User-Based Time Context**: Pass user timezone directly in conversation requests
90
+ - **Global Time Management**: Get precise time in any timezone using NTP synchronization
91
+ - **Timezone Preservation**: Maintains timezone context during agent handoffs
92
+ - **Default Fallbacks**: Configurable defaults at both agent and swarm levels
93
+ - **Contextual Date Awareness**: All agents understand "today," "next week," or "in 3 days" relative to user's timezone
94
+
95
+ ## Why Choose Solana Agent Over LangChain?
96
+
97
+ ### 🎯 Key Differentiators
98
+
99
+ #### 💡 **AGI-First Architecture**
100
+ - Designed for autonomous intelligence and self-improvement
101
+ - Framework for agents to improve themselves without human intervention
102
+
103
+ #### 🧠 **Advanced Memory Architecture**
104
+ - Sophisticated episodic and semantic memory vs. basic memory types
105
+ - Cross-session knowledge retention with importance-based storage
106
+ - Autonomous extraction of insights from conversations
107
+ - Collective memory across users and agents
108
+
109
+ #### 🤝 **True Multi-Agent Orchestration**
110
+ - First-class swarm intelligence with specialized agent teams
111
+ - Dynamic routing based on expertise and query complexity
112
+ - Seamless context preservation during handoffs
113
+ - Single unified interface for the entire agent ecosystem
114
+ - Unified mission framework for consistent decision making
115
+
116
+ #### 🏢 **Enterprise Production Readiness**
117
+ - Deployment-ready with minimal configuration
118
+ - Comprehensive error handling and recovery mechanisms
119
+ - Scalable architecture supporting high-concurrency environments
120
+ - Privacy-preserving design with configurable controls
121
+
122
+ #### 🛠️ **Developer Experience**
123
+ - Clean, intuitive API without excessive abstractions
124
+ - Standard Python functions vs complex chaining constructs
125
+ - Minimal boilerplate for common operations
126
+ - ~1500 vs ~500,000 lines of code
127
+
128
+ ## Installation
129
+
130
+ You can install Solana Agent using pip:
131
+
132
+ ```bash
133
+ pip install solana-agent
134
+ ```
135
+
136
+ ## Documentation
137
+ * Each public method has a docstring for real-time IDE hinting
138
+
139
+ ## Production Apps
140
+ * [CometHeart](https://cometheart.com) - AI Companion and Business Coach on mobile using voice-to-voice conversations
141
+
142
+ ## Example Apps
143
+ * [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app) - See as source of documentation
144
+
145
+ ## License
146
+
147
+ This project is licensed under the MIT License - see the LICENSE file for details.
@@ -1,12 +1,12 @@
1
1
  [tool.poetry]
2
2
  name = "solana-agent"
3
- version = "6.0.0"
4
- description = "Build self-learning AI Agents"
3
+ version = "7.0.0"
4
+ description = "The first AGI framework"
5
5
  authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
6
6
  license = "MIT"
7
7
  readme = "README.md"
8
8
  repository = "https://github.com/truemagic-coder/solana-agent"
9
- keywords = ["ai", "openai", "ai agents"]
9
+ keywords = ["ai", "openai", "ai agents", "agi"]
10
10
  classifiers = [
11
11
  "Programming Language :: Python :: 3 :: Only",
12
12
  "Topic :: Scientific/Engineering :: Artificial Intelligence",
@@ -18,7 +18,7 @@ python_paths = [".", "tests"]
18
18
 
19
19
  [tool.poetry.dependencies]
20
20
  python = ">=3.9,<4.0"
21
- openai = "^1.65.1"
21
+ openai = "^1.65.2"
22
22
  pydantic = "^2.10.6"
23
23
  pymongo = "^4.11.1"
24
24
  zep-cloud = "^2.4.0"
@@ -28,6 +28,11 @@ pinecone = "^6.0.1"
28
28
  pandas = "^2.2.3"
29
29
  ntplib = "^0.4.0"
30
30
 
31
+ [tool.poetry.dev-dependencies]
32
+ pytest = "^8.3.4"
33
+ pytest-cov = "^6.0.0"
34
+ pytest-asyncio = "^0.25.3"
35
+
31
36
  [build-system]
32
37
  requires = ["poetry-core>=1.0.0"]
33
38
  build-backend = "poetry.core.masonry.api"