solana-agent 6.0.1__py3-none-any.whl → 8.0.0__py3-none-any.whl

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,248 @@
1
+ Metadata-Version: 2.3
2
+ Name: solana-agent
3
+ Version: 8.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.3,<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.2,<5.0.0)
25
+ Requires-Dist: requests (>=2.32.3,<3.0.0)
26
+ Requires-Dist: zep-cloud (>=2.5.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
+ Reinventing Organizational Structures Through AI
42
+ Solana Agent isn't just an AI framework—it's the foundation for reimagining how humans organize, collaborate, and create value together. Build organizations that transcend traditional hierarchies and unlock collective intelligence at scale.
43
+
44
+ ### The Future of Work Starts Here:
45
+
46
+ - **Decentralized Decision Making:**
47
+ Enable distributed expertise through AI-human collaboration, removing bottlenecks and centralizing only the mission, not the authority.
48
+
49
+ - **Organization as Living Code:**
50
+ Define your organization's values, expertise boundaries, and operating principles in code, making structure transparent and adaptable.
51
+
52
+ - **Fluid Collaboration Networks:**
53
+ Replace rigid hierarchies with dynamic agent networks that form, collaborate, and dissolve based on real-time needs.
54
+
55
+ - **Knowledge as Collective Asset:**
56
+ Transform individual expertise into organizational intelligence through autonomous knowledge extraction and distribution.
57
+
58
+ - **Permissionless Value Creation:**
59
+ Let agents (both AI and human) contribute and innovate freely within guardrails defined by mission and values, not management layers.
60
+
61
+ ## The Future of Work
62
+
63
+ Solana Agent enables a paradigm shift in how work gets done:
64
+
65
+ - **Beyond Human Resource Constraints:**
66
+ Scale knowledge work infinitely by combining specialized AI agents with human experts.
67
+ - **Continuous 24/7 Operations:**
68
+ Organizational functions that never sleep, never burn out, and continuously learn.
69
+ - **Task-Agent Fit Optimization:**
70
+ Matching work to the ideal agent (human or AI) based on real-time expertise mapping.
71
+ - **Ambient Organizational Intelligence:**
72
+ Collective knowledge that grows, refines, and distributes itself autonomously.
73
+ - **From Managers to Facilitators:**
74
+ Human roles shift from directing work to defining outcomes and improving agent capabilities.
75
+ - **Permissionless Contribution:**
76
+ Anyone can interact with and extend the organization through standardized interfaces.
77
+
78
+ ## Organization as Code
79
+
80
+ With Solana Agent, your organizational design becomes explicit, observable, and iteratively improvable:
81
+
82
+ - **Declarative Organizational Structure:**
83
+ Define your entire organization's capabilities through agent specializations and interaction patterns.
84
+ - **Version-Controlled Operational Logic:**
85
+ Track organizational evolution and performance through code changes.
86
+ - **Mission Function:**
87
+ Encode organizational values and goals as executable functions that guide all agent decisions.
88
+ - **Rapid Organizational Experiments:**
89
+ Test new structures, policies, and collaborative patterns without disruptive reorganizations.
90
+ - **Transparency by Default:**
91
+ Make decision boundaries and expertise domains explicit in code rather than hidden in hierarchy.
92
+ - **Self-Documenting Operations:**
93
+ The organization continuously documents its own functions, decisions, and knowledge.
94
+
95
+ ## Decentralized Organization
96
+
97
+ Solana Agent provides the infrastructure to build truly decentralized organizations:
98
+
99
+ - **Multi-Node Intelligence:**
100
+ Distribute cognitive load across specialized agents with no central controller.
101
+ - **Autonomous Coordination:**
102
+ Agents self-organize based on capabilities and availability without central dispatching.
103
+ - **Edge Decision Making:**
104
+ Push decisions to the agents closest to the information and expertise needed.
105
+ - **Resilient Architecture:**
106
+ No single point of failure in organizational knowledge or operational capacity.
107
+ - **Emergent Problem Solving:**
108
+ Solutions emerge from collaborative agent interactions rather than top-down directives.
109
+ - **Fractal Scaling:**
110
+ Add new domains of expertise by replicating the agent swarm pattern without hierarchical constraints.
111
+
112
+ ## Complete Flat Organization
113
+
114
+ Eliminate management hierarchies while maintaining coordination and alignment:
115
+
116
+ - **Mission-Driven Alignment:**
117
+ All agents align through shared values and outcomes defined in the unified mission framework.
118
+ - **Peer-to-Peer Handoffs:**
119
+ Both AI and human agents coordinate as equals through standardized interfaces.
120
+ - **Expertise-Based Authority:**
121
+ Influence derives from demonstrable expertise rather than position.
122
+ - **Universal Access Protocol:**
123
+ Consistent interfaces for interacting with any part of the organization.
124
+ - **Transparent Contribution Tracking:**
125
+ Meritocratic recognition of value creation across the network.
126
+ - **Adaptive Resource Allocation:**
127
+ Direct resources to high-impact areas without bureaucratic approval chains.
128
+
129
+ ## Technical Features
130
+
131
+ - **🗣️ Advanced Interaction Layer:**
132
+ Streaming text-based conversations with real-time thinking.
133
+ Voice-to-voice conversations with natural cadence.
134
+ Multi-turn context preservation and reasoning.
135
+
136
+ - **🤖 Multi-Agent Swarm Architecture:**
137
+ Dynamic specialized agent creation and coordination.
138
+ Intelligent routing based on query content and agent expertise.
139
+ Seamless handoffs with comprehensive context passing.
140
+ Shared memory and collective intelligence across the entire swarm.
141
+
142
+ - **👥 Human-AI Collaboration:**
143
+ Hybrid AI-human collaboration system with seamless handoffs.
144
+ Ticket management for complex or sensitive inquiries.
145
+ Multiple handoff patterns (AI↔human, human↔human).
146
+ In-chat command system for human agents to manage tickets.
147
+ Availability status management for human operators.
148
+
149
+ - **🧠 Distributed Intelligence Capabilities:**
150
+ Cross-domain knowledge integration from multiple sources.
151
+ Self-organizing information architecture.
152
+ Autonomous knowledge extraction and refinement.
153
+ Time-aware contextual responses.
154
+ Self-critical improvement systems.
155
+
156
+ - **🛡️ Governance Framework:**
157
+ Define organization-wide values and operating principles in code.
158
+ Consistent decision-making aligned with organizational priorities.
159
+ Privacy-preserving knowledge sharing with configurable controls.
160
+ Transparent insight extraction with review capabilities.
161
+ Performance analytics across the agent network.
162
+
163
+ ## Implementation Technologies
164
+
165
+ Solana Agent leverages multiple technologies to enable these capabilities:
166
+
167
+ - **Knowledge Integration:**
168
+ Perplexity API, X/Twitter (Grok API), Zep memory, Pinecone vector search.
169
+ - **Collaborative Intelligence:**
170
+ Multi-agent swarm architecture with specialized expertise domains.
171
+ - **Human-AI Teaming:**
172
+ Integrated ticketing, notification systems, and real-time handoffs.
173
+ - **Organization Alignment:**
174
+ Unified mission framework, critic system, and collective memory.
175
+
176
+ ## Installation
177
+
178
+ You can install Solana Agent using pip:
179
+
180
+ `pip install solana-agent`
181
+
182
+ ## Documentation
183
+
184
+ Each public method has a docstring for real-time IDE hinting.
185
+
186
+ ## Production Apps
187
+
188
+ - **CometHeart:**
189
+ AI Companion and Business Coach on mobile using voice-to-voice conversations.
190
+
191
+ ## Example Setup
192
+
193
+ ```python
194
+ # Create a decentralized organizational structure
195
+ from solana_agent.ai import Swarm, AI, MongoDatabase
196
+
197
+ # Initialize the organizational database
198
+ db = MongoDatabase(db_url="mongodb://localhost:27017", db_name="organization_brain")
199
+
200
+ # Define the organization's mission and values
201
+ mission = """Our organization maximizes collective intelligence through
202
+ transparent collaboration between humans and AI. We value truth,
203
+ clarity, and continuous improvement in all interactions."""
204
+
205
+ # Create the organizational swarm
206
+ org = Swarm(
207
+ database=db,
208
+ directive=mission,
209
+ )
210
+
211
+ # Register AI expertise domains
212
+ org.register(
213
+ name="knowledge_worker",
214
+ agent=AI(
215
+ openai_api_key="key",
216
+ instructions="You are an expert in research and knowledge synthesis...",
217
+ database=db
218
+ ),
219
+ specialization="Research, analysis, and knowledge synthesis"
220
+ )
221
+
222
+ org.register(
223
+ name="customer_interface",
224
+ agent=AI(
225
+ openai_api_key="key",
226
+ instructions="You handle customer inquiries with empathy and clarity...",
227
+ database=db
228
+ ),
229
+ specialization="Customer interaction and support"
230
+ )
231
+
232
+ # Register human expertise domains
233
+ org.register_human_agent(
234
+ agent_id="human_expert_1",
235
+ name="Technical Specialist",
236
+ specialization="Advanced technical problem solving requiring human judgment",
237
+ notification_handler=email_notification
238
+ )
239
+
240
+ # Process work through the organization
241
+ async for response in org.process("user123", "How can we optimize our supply chain?"):
242
+ print(response, end="")
243
+ ```
244
+
245
+ ## License
246
+
247
+ This project is licensed under the MIT License - see the LICENSE file for details.
248
+
@@ -0,0 +1,6 @@
1
+ solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
2
+ solana_agent/ai.py,sha256=V-FnRpeelDXWFXtNo-nh2vJmokW-rh8YmMP0-ws5-AE,120530
3
+ solana_agent-8.0.0.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
4
+ solana_agent-8.0.0.dist-info/METADATA,sha256=KbPPixmQEOH1ZzFmTofw9Veadmuo1niP_j00AqAm1VY,10283
5
+ solana_agent-8.0.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
6
+ solana_agent-8.0.0.dist-info/RECORD,,
@@ -1,139 +0,0 @@
1
- Metadata-Version: 2.3
2
- Name: solana-agent
3
- Version: 6.0.1
4
- Summary: Build self-learning AI Agent Swarm
5
- License: MIT
6
- Keywords: ai,openai,ai agents
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.1,<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
-
35
- ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
36
-
37
- Solana Agent is the first self-learning AI Agent Swarm framework.
38
-
39
- ## Why Solana Agent?
40
-
41
- ### 🧬 The First Self-Learning AI Agent Swarm Framework
42
-
43
- Unlike traditional AI assistants that forget conversations after each session, Solana Agent maintains a rich, searchable memory system that grows smarter with every interaction.
44
-
45
- **Why This Matters:**
46
- - 🤖 **Swarm Intelligence**: Shares memory across all agents in the swarm
47
- - 📈 **Continuous Learning**: Evolves with every new interaction
48
- - 🎯 **Context-Aware**: Recalls past interactions for more relevant responses
49
- - 🔄 **Self-Improving**: Builds knowledge and improves reasoning automatically
50
- - 🧠 **Knowledge Base**: Add domain-specific knowledge for better reasoning
51
- - 🛡️ **Secure**: Secure and private memory and data storage
52
-
53
- **Experience Agentic IQ!**
54
-
55
- ## Features
56
-
57
- 🔄 **Real-time AI Interactions**
58
- - Streaming text-based conversations
59
- - Real-time voice-to-voice conversations
60
-
61
- 🧠 **Memory System and Extensibility**
62
- - Advanced AI memory combining conversational context, knowledge base, and parallel tool calling
63
- - Create custom tools for extending the Agent's capabilities like further API integrations
64
-
65
- 🤖 **Multi-Agent Swarms**
66
- - Create specialized agents with different expertise domains
67
- - Automatic routing of queries to the most appropriate specialist
68
- - Seamless handoffs between agents for complex multi-domain questions
69
- - Shared memory and context across the entire agent swarm
70
-
71
- 🔍 **Multi-Source Search and Reasoning**
72
- - Internet search via Perplexity
73
- - X (Twitter) search using Grok
74
- - Conversational memory powered by Zep
75
- - Conversational message history using MongoDB (on-prem or hosted)
76
- - Knowledge Base (KB) using Pinecone with reranking - available globally or user-specific
77
- - Upload CSVs to be processed into summary reports and stored in the Knowledge Base (KB) using Gemini
78
- - Comprehensive reasoning combining multiple data sources
79
-
80
- ## Why Choose Solana Agent Over LangChain?
81
-
82
- ### 🎯 Key Differentiators
83
-
84
- 🧠 **Advanced Memory Architecture**
85
- - Built-in episodic memory vs LangChain's basic memory types
86
- - Persistent cross-session knowledge retention
87
- - Automatic self-learning from conversations
88
- - Knowledge Base to add domain specific knowledge
89
- - CSV file uploads to perform document context search
90
-
91
- 🤝 **Intelligent Multi-Agent Systems**
92
- - First-class support for specialized agent swarms
93
- - Dynamic inter-agent routing based on query complexity
94
- - Seamless handoffs with continuous memory preservation
95
- - Single unified interface for the entire agent network
96
- - No custom coding required for agent coordination
97
-
98
- 🏢 **Enterprise Focus**
99
- - Production-ready out of the box in a few lines of code
100
- - Enterprise-grade deployment options for all components and services
101
- - Simple conventions over complex configurations
102
-
103
- 🛠️ **Simplified Development**
104
- - No chain building required
105
- - Python plain functions vs complex chaining
106
- - Fewer moving parts equals more stable applications
107
- - Smaller repo size by 1000x: Solana Agent @ ~500 LOC vs LangChain @ ~500,000 LOC
108
-
109
- 🚀 **Performance**
110
- - Optimized for real-time streaming responses
111
- - Built-in voice processing capabilities
112
- - Multi-source search with automatic reasoning synthesis
113
-
114
- ## Installation
115
-
116
- You can install Solana Agent using pip:
117
-
118
- ```bash
119
- pip install solana-agent
120
- ```
121
-
122
- ## Documentation
123
- * Each public method has a docstring for real-time IDE hinting
124
-
125
- ## Production Apps
126
- * [Solana Agent Copilot](https://ai.solana-agent.com) - Solana Token AI Copilot using streaming text conversations
127
- * [CometHeart](https://cometheart.com) - AI Companion and Business Coach on mobile using voice-to-voice conversations
128
-
129
- ## Example Apps
130
- * [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app) - See as source of documentation
131
-
132
- ## Contributing
133
-
134
- Contributions to Solana Agent are welcome! Please feel free to submit a Pull Request.
135
-
136
- ## License
137
-
138
- This project is licensed under the MIT License - see the LICENSE file for details.
139
-
@@ -1,6 +0,0 @@
1
- solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
2
- solana_agent/ai.py,sha256=zwxvAOBhmdzUr9KLeTCsRW1Kg8LpIxJiu0PtxhQj-cI,57017
3
- solana_agent-6.0.1.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
4
- solana_agent-6.0.1.dist-info/METADATA,sha256=gVlVVSjbjhoSWIN_7BMez1gmiy46q4pXDau-mNdW144,5443
5
- solana_agent-6.0.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
6
- solana_agent-6.0.1.dist-info/RECORD,,