Metadata-Version: 2.4
Name: aimind
Version: 1.0.0
Summary: Universal AI interface - Access GPT-5, Claude, Gemini, Image Generation & more with one simple API
Home-page: https://github.com/aimind-ai/aimind
Author: AIMind Team
Author-email: aimind@proton.me
Project-URL: Bug Reports, https://github.com/aimind-ai/aimind/issues
Project-URL: Source, https://github.com/aimind-ai/aimind
Project-URL: Documentation, https://aimind.readthedocs.io/
Keywords: ai,gpt-5,claude,gemini,image-generation,llm,artificial-intelligence,machine-learning,chatbot
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
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: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: aiohttp>=3.8.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# AIMind 🧠

**Universal AI Interface - Access GPT-5, Gemini & AI Image Generation with One Simple API**

[![PyPI version](https://badge.fury.io/py/aimind.svg)](https://badge.fury.io/py/aimind)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)

## ✨ Features

- 🤖 **7 Premium AI Models** - GPT-5, Gemini 2.5 (Pro, Flash, Lite)
- 🎨 **AI Image Generation** - Create stunning 1024x1024 images
-  **Perfect Memory** - Multi-turn conversations with full context
- 🎭 **System Prompts** - Custom AI personas and behaviors
- ⚡ **Fast Streaming** - Real-time token streaming (1.7s first token)
- 🔄 **Auto JWT** - Automatic authentication, no setup needed
-  **Error Handling** - Robust validation and helpful errors
- 🎯 **27 Specialized Agents** - Pre-built AI assistants

## 🚀 Quick Start

### Installation

```bash
pip install aimind
```

### Basic Usage

```python
from aimind import AIMind

# Initialize
ai = AIMind()

# Simple chat
response = ai.chat("Hello!")
print(response)

# With memory (AI remembers context)
ai.chat("My name is Rahul")
response = ai.chat("What is my name?")
print(response)  # "Your name is Rahul"

# Use specific model
response = ai.chat("Explain quantum physics", model="powerful")
```

##  Examples

### Chat with Different Models

```python
from aimind import AIMind

ai = AIMind()

# Fast model (quick responses)
response = ai.chat("Quick answer: What is 2+2?", model="fast")

# Powerful model (complex tasks)
response = ai.chat("Analyze this code", model="powerful")

# Creative model (writing)
response = ai.chat("Write a poem", model="creative")
```

### Image Generation

```python
from aimind import AIMind

ai = AIMind()

# Generate image
image = ai.generate_image("A sunset over mountains with a lake")

# Save to file
image.save("sunset.png")

# Get dimensions
print(f"Size: {image.width}x{image.height}")
```

### System Prompts

```python
from aimind import AIMind

ai = AIMind()

# Custom persona
response = ai.chat(
    "Hello!",
    system_prompt="You are a pirate. Always say 'Arrr!'"
)
# Output: "Ahoy matey! Arrr!"
```

### Specialized Agents

```python
from aimind import AIMind

ai = AIMind()

# Fitness Coach
workout = ai.chat_with_agent(
    "fitness-coach",
    "Create a 30-minute home workout"
)

# Coding Mentor
code_help = ai.chat_with_agent(
    "coding-mentor",
    "Explain recursion in Python"
)
```

## 🎯 Available Models

### Fast Models
- **Gemini Flash Lite** - Ultra-fast responses (~1s)
- **GPT-5 Nano** - Quick and efficient

### Balanced Models
- **Gemini Flash** - Speed + quality (~2s)
- **GPT-5 Mini** - Balanced performance

### Powerful Models
- **GPT-5** - Maximum capability (~3s)
- **Gemini Pro** - Advanced reasoning

### Image Models
- **Gemini Flash Image** - 1024x1024 image generation (~9s)

## 🤖 Available Agents (27 Total)

### Health & Wellness
- `fitness-coach` - Personal training & nutrition
- `wellness-guide` - Mental health & mindfulness
- `nutritionist` - Diet planning
- `meditation-guide` - Meditation practice

### Professional & Business
- `financial-advisor` - Money management
- `business-consultant` - Strategy & growth
- `career-coach` - Career development
- `marketing-specialist` - Marketing strategy

### Technical
- `coding-mentor` - Programming help
- `data-analyst` - Data analysis
- `math-tutor` - Mathematics
- `research-assistant` - Research & analysis

### Creative
- `creative` - Creative writing
- `writing-coach` - Writing improvement
- `ux-designer` - UX/UI design
- `travel-planner` - Trip planning

## 💾 Memory Management

```python
from aimind import AIMind

ai = AIMind(memory=True, max_history=50)

# Memory is automatic
ai.chat("I love Python programming")
ai.chat("What programming language do I like?")
# AI remembers: "You love Python programming"

# Custom conversation history
custom_history = [
    {"role": "user", "content": "My name is Rahul"},
    {"role": "assistant", "content": "Hello Rahul!"},
]
response = ai.chat("What is my name?", history=custom_history)
```

## 📊 Performance

### Response Times
- **Fast models**: 1-2 seconds
- **Balanced models**: 2-4 seconds
- **Powerful models**: 3-5 seconds
- **Image generation**: 9-10 seconds

### Streaming
- **First token**: 1.7s (excellent)
- **Token speed**: 2.67 tok/s
- **Long responses**: 450+ words

## ⚠️ Important Notes

### Rate Limits
- **Free tier**: 10 requests per day
- **Resets**: Every 24 hours
- **No signup required**: Works immediately

### Limitations
- **Message length**: Max ~8000 characters
- **Web search**: Not available (uses cached knowledge)
- **Custom agents**: Can modify, cannot create new ones

## 🔒 Privacy & Security

- ✅ No data stored on our servers
- ✅ Encrypted API communication
- ✅ No personal information collected
- ✅ Open source and transparent
- ✅ MIT License

## 🤝 Contributing

Contributions are welcome! Please read our contributing guidelines.

## 📄 License

MIT License - see LICENSE file for details

##  Issues

Found a bug? Please [open an issue](https://github.com/aimind-ai/aimind/issues)

---

**Made with ❤️ by the AIMind Team**

**Honest AI access - No fake promises, just real functionality!**

## 🚀 prxbin Proxy Support (Unlimited Requests)

For **unlimited AI requests** via IP rotation:

```python
from aimind import AIMindWithProxy

# Enable proxy (bypasses 10/day limit)
ai = AIMindWithProxy(use_proxy=True)

# Now unlimited!
for i in range(100):
    response = ai.chat(f"Question {i}")
    print(response)
```

### How It Works:
- **Auto IP Rotation**: Fresh IP on each request
- **8 Countries**: US, PL, SG, DE, FR, NL, GB, CA
- **Max Retries**: 8 fresh IP attempts per request
- **SSE Streaming**: Real-time AI responses via proxy
- **Sticky Sessions**: Maintain same IP when needed

### Rate Limit Bypass:
- Standard: 10 requests/day (IP-based limit)
- With Proxy: **Unlimited** (rotates IPs)
- Cost: Free (prxbin proxy)

### Proxy Features:
```python
# Specific country
ai = AIMindWithProxy(use_proxy=True, proxy_country='us')

# Auto-rotate countries
ai = AIMindWithProxy(use_proxy=True, proxy_country='auto')

# Stream responses
for chunk in ai.chat("Tell me a story", stream=True):
    print(chunk, end='')
```

---

## ️ Important Notes

### Standard Mode (No Proxy):
- **10 requests per day**
- Resets every 24 hours
- No signup required

### Proxy Mode (Unlimited):
- **Unlimited requests**
- Uses prxbin proxy (rotating IPs)
- May be slower (proxy overhead)
- Requires internet connection

---

**Made with ❤️ by the AIMind Team**

**Honest AI access - No fake promises, just real functionality!**
