aimind 1.0.0__tar.gz

aimind-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AIMind Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aimind-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include aimind *.py

aimind-1.0.0/PKG-INFO

@@ -0,0 +1,335 @@
+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!**

aimind-1.0.0/README.md

@@ -0,0 +1,294 @@
+# 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!**

aimind-1.0.0/aimind/__init__.py

@@ -0,0 +1,56 @@
+"""
+AIMind - Universal AI Interface
+
+Access GPT-5, Claude, Gemini, Image Generation & more with one simple API.
+
+Features:
+    - 7 AI Models (GPT-5, Gemini)
+    - 27 Custom Agents
+    - Image Generation
+    - Web Search
+    - Memory Support
+    - Streaming Responses
+    - prxbin Proxy (Rate Limit Bypass)
+    - Auto JWT Refresh
+
+Usage:
+    from aimind import AIMind, AIMindWithProxy
+    
+    # Standard (10 requests/day)
+    ai = AIMind()
+    response = ai.chat("Hello!")
+    
+    # With Proxy (Unlimited via IP rotation)
+    ai = AIMindWithProxy(use_proxy=True)
+    response = ai.chat("Hello!")
+"""
+
+__version__ = "1.0.0"
+__author__ = "AIMind Team"
+
+from .client import AIMind, AIMindWithProxy
+from .models import Models
+from .agents import Agents
+from .memory import Memory
+from .image import GeneratedImage
+from .exceptions import (
+    AIMindError,
+    AuthenticationError,
+    RateLimitError,
+    ModelNotAvailableError,
+    ImageGenerationError,
+)
+
+__all__ = [
+    "AIMind",
+    "AIMindWithProxy",
+    "Models",
+    "Agents",
+    "Memory",
+    "GeneratedImage",
+    "AIMindError",
+    "AuthenticationError",
+    "RateLimitError",
+    "ModelNotAvailableError",
+    "ImageGenerationError",
+]