Metadata-Version: 2.1
Name: solana-agentkit
Version: 0.1.0
Summary: A Python toolkit for building AI agents on Solana
Home-page: https://github.com/arhansuba/solana-agentkit
Author: Arhan SUbaşı
Author-email: subasiarhan3@gmail.com
Project-URL: Bug Tracker, https://github.com/arhansuba/solana-agentkit/issues
Project-URL: Documentation, https://solana-agentkit.readthedocs.io/
Project-URL: Source Code, https://github.com/arhansuba/solana-agentkit
Keywords: solana,blockchain,artificial-intelligence,ai-agents,cryptocurrency,web3,defi,nft
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: docs

# Solana AgentKit Documentation

Welcome to the Solana AgentKit documentation! This Python package provides tools and utilities for building AI agents that can interact with the Solana blockchain.

## Quick Start

### Installation

```bash
# Basic installation
pip install solana-agentkit

# With development tools
pip install solana-agentkit[dev]

# With documentation tools
pip install solana-agentkit[docs]
```

### Basic Usage

```python
from solana_agentkit import SolanaAgent
from solana_agentkit.tools import transfer_tokens, get_balance

# Initialize agent
agent = SolanaAgent(
    private_key="your_private_key",
    rpc_url="https://api.mainnet-beta.solana.com"
)

# Check balance
balance = await agent.get_balance()
print(f"Current balance: {balance} SOL")

# Transfer tokens
result = await agent.transfer(
    to="recipient_address",
    amount=1.0
)
print(f"Transfer successful: {result.signature}")
```

## Features

### Core Components

- **Agent Framework**: Build and deploy AI agents on Solana
- **Transaction Tools**: Simplified transaction creation and management
- **NFT Utilities**: Create and manage NFT collections
- **Token Tools**: Deploy and manage SPL tokens
- **Domain Management**: Register and manage .sol domains

### AI Integration

- LangChain integration for AI capabilities
- OpenAI integration for image generation
- Custom agent behaviors and personalities
- Natural language processing for commands

### Blockchain Features

- Wallet management
- Transaction building
- Priority fee handling
- Multi-signature support

## Development

### Setup Development Environment

```bash
# Clone repository
git clone https://github.com/arhansuba/solana-agentkit
cd solana-agentkit

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Unix
# or
.\venv\Scripts\activate  # Windows

# Install development dependencies
pip install -r requirements.txt
```

### Running Tests

```bash
# Run all tests
pytest tests/

# Run with coverage
pytest --cov=solana_agentkit tests/
```

### Code Style

We use Black for code formatting and isort for import sorting:

```bash
# Format code
black src/ tests/

# Sort imports
isort src/ tests/
```

## Project Structure

```
solana-agentkit/
├── docs/               # Documentation
├── src/               # Source code
│   └── solana_agentkit/
│       ├── agent/     # Agent implementations
│       ├── tools/     # Blockchain tools
│       └── utils/     # Utility functions
├── tests/             # Test suite
└── examples/          # Usage examples
```

## Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## License

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

## Support

- GitHub Issues: [Report bugs](https://github.com/arhansuba/solana-agentkit/issues)
- Documentation: [Read the docs](https://solana-agentkit.readthedocs.io/)
- Discord: [Join our community](#)

## Acknowledgments

- Solana Foundation
- LangChain team
- All contributors# solana-agentkit
