Metadata-Version: 2.3
Name: solana-agent
Version: 0.0.3
Summary: The Best AI Agent Framework
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: aiosqlite (>=0.21.0,<0.22.0)
Requires-Dist: motor (>=3.7.0,<4.0.0)
Requires-Dist: openai (>=1.61.1,<2.0.0)
Requires-Dist: pydantic (>=2.10.6,<3.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: zep-python (>=2.0.2,<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 best AI Agent framework.

## Features

- Streaming text-based conversations with AI
- Audio transcription and streaming text-to-speech conversion
- Thread management for maintaining conversation context
- Message persistence using SQLite or MongoDB
- Custom tool integration for extending AI capabilities
- The best memory context currently available for AI Agents
- Zep integration for tracking facts
- Search Internet with Perplexity tool
- Search Zep facts tool
- Search X with Grok tool
- Reasoning tool that combines OpenAI model reasoning, Zep facts, Internet search, and X search.
- Solana tools upcoming...

## Installation

You can install Solana Agent using pip:

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

## Usage

Here's a basic example of how to use Solana Agent:

```python
from solana_agent import AI, SQLiteDatabase

async def main():
    database = SQLiteDatabase("conversations.db")
    async with AI("your_openai_api_key", "AI Assistant", "Your instructions here", database) as ai:
        user_id = "user123"
        response = await ai.text(user_id, "Hello, AI!")
        async for chunk in response:
            print(chunk, end="", flush=True)
        print()

# Run the async main function
import asyncio
asyncio.run(main())
```

## Production Apps
* [Solana Agent](https://solana-agent.com) - AI Market Intelligence
* [CometHeart](https://cometheart.com) - AI Companion

## 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.

