Metadata-Version: 2.3
Name: solana-agent
Version: 0.0.9
Summary: Build self-learning AI Agents
License: MIT
Keywords: ai,openai,ai agents
Author: Bevan Hunt
Author-email: bevan@bevanhunt.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Dist: motor (>=3.7.0,<4.0.0)
Requires-Dist: openai (>=1.61.1,<2.0.0)
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Requires-Dist: pinecone (>=6.0.1,<7.0.0)
Requires-Dist: pydantic (>=2.10.6,<3.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: zep-cloud (>=2.3.1,<3.0.0)
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/)

![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)

Solana Agent is the first self-learning AI Agent framework.

## Why Solana Agent?

### 🧬 The First Self-Learning AI Agent

Unlike traditional AI assistants that forget conversations after each session, Solana Agent maintains a rich, searchable memory system that grows smarter with every interaction.

**Why This Matters:**
- 📈 **Continuous Learning**: Evolves with every new interaction
- 🎯 **Context-Aware**: Recalls past interactions for more relevant responses
- 🔄 **Self-Improving**: Builds knowledge and improves reasoning automatically
- 🏢 **Enterprise-Ready**: Scales from personal to organization-wide deployment
- 🛡️ **Secure**: Secure and private memory and data storage 

**"It's not just an AI assistant - it's your organization's evolving intelligence layer."**

## Benefits

💬 **Enhanced Communication**
- Engage in natural conversations without typing delays
- Communicate hands-free with voice interactions
- Reduce response time with real-time processing

🎯 **Improved Decision Making**
- Access comprehensive data from multiple trusted sources
- Get instant answers backed by Internet and social-media research
- Make informed decisions with cross-referenced information

💪 **Operational Efficiency**
- Automate repetitive data processing tasks
- Convert data formats seamlessly
- Scale knowledge management effortlessly

🔐 **Enterprise Ready**
- Secure data handling with advanced memory systems
- Customize functionality through extensible architecture
- Integrate with existing business tools and APIs

🚀 **Competitive Advantage**
- Stay current with real-time social media and Internet insights
- Process and analyze large datasets quickly
- Transform raw data into actionable intelligence

## Features

🔄 **Real-time AI Interactions**
- Streaming text-based conversations
- Real-time voice-to-voice conversations

🧠 **Memory System and Extensibility**
- Advanced AI memory combining conversational context, conversational facts, and knowledge base
- Simple custom tool creation for extending capabilities like additional API integrations

🔍 **Multi-Source Search and Reasoning**
- Internet search via Perplexity
- Conversational fact search powered by Zep
- X (Twitter) search using Grok
- Conversational message history using MongoDB (on-prem or hosted)
- Knowledge Base search via Pinecone
- Comprehensive reasoning combining multiple data sources

🛠️ **Data Processing Tools**
- CSV to JSON conversion for data integration
- Text summarization powered by Gemini
- Enterprise-ready knowledge base powered by Pinecone

## Why Choose Solana Agent Over LangChain?

### 🎯 Key Differentiators

🧠 **Advanced Memory Architecture**
   - Built-in episodic memory vs LangChain's basic memory types
   - Persistent cross-session knowledge retention
   - Automatic self-learning from conversations

🏢 **Enterprise Focus**
   - Production-ready out of the box in a few lines of code
   - Enterprise-grade deployment options for all components and services
   - Simple conventions over complex configurations

🛠️ **Simplified Development**
   - No chain building required
   - Python plain functions vs complex chaining
   - Fewer moving parts equals more stable applications
   - Smaller repo size by 1000x: Solana Agent @ ~500 LOC vs LangChain @ ~500,000 LOC

🚀 **Performance**
   - Optimized for real-time streaming responses
   - Built-in voice processing capabilities
   - Multi-source search with automatic reasoning synthesis

## Installation

You can install Solana Agent using pip:

```bash
pip install solana-agent
```

## Documentation
* All public methods have docstrings for real-time IDE hinting

## Production Apps
* [Solana Agent Copilot](https://ai.solana-agent.com) - Solana Token AI Copilot using streaming text conversations
* [CometHeart](https://cometheart.com) - AI Companion and Business Coach on mobile using voice-to-voice conversations

## Example Apps
* [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app) - See as source of documentation

## Contributing

Contributions to Solana Agent are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the MIT License - see the LICENSE file for details.

