Metadata-Version: 2.4
Name: aimind
Version: 1.1.0
Summary: Universal AI interface - Access multiple AI models, image generation, and 27 specialized agents with one simple API
Home-page: https://t.me/glitchyapi
Author: GlitchyAPI
Author-email: glitchyapi@gmail.com
Project-URL: Support, https://t.me/glitchyapi
Project-URL: Contact, https://t.me/glitchyapi
Keywords: ai,gpt-5,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

**One API. 7 AI Models. Image Generation. Custom Agents. Privacy-First.**

[![PyPI version](https://badge.fury.io/py/aimind.svg)](https://pypi.org/project/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 AI Models** - GPT-5, Gemini 2.5 (Pro/Flash/Lite), and more
- **Image Generation** - 1024x1024 with 8 aspect ratios, 11 styles, 3 quality levels
- **27 Built-in Agents** - Fitness coach, coding mentor, business consultant, etc.
- **Custom Agents** - Create your own AI personas with local storage
- **Streaming** - Token-by-token responses for fast UX
- **Memory** - Multi-turn conversations with context
- **Health Checks** - Parallel diagnostics to verify all models
- **Privacy-First** - Local storage only, no cloud, no tracking

##  Installation

```bash
pip install aimind
```

##  Quick Start

```python
from aimind import AIMind

ai = AIMind()

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

# Stream tokens
for chunk in ai.chat_stream("Tell me a story"):
    print(chunk, end="", flush=True)

# Generate image
img = ai.generate_image("A sunset over mountains")
img.save("sunset.png")
```

##  Available Models (2026)

### Chat Models

**Fast (~1s)**
- `google/gemini-2.5-flash-lite`
- `openai/gpt-5-nano`

**Balanced (~2s)**
- `google/gemini-2.5-flash`
- `openai/gpt-5-mini`

**Powerful (~3-4s)**
- `google/gemini-2.5-pro`
- `openai/gpt-5`

### Image Models

- `google/gemini-2.5-flash-image` - 1024x1024, fast

##  Image Generation

```python
from aimind import AIMind, AspectRatio, ImageStyle, ImageQuality

ai = AIMind()

# Cinematic wallpaper (16:9)
img = ai.generate_image(
    "Epic mountain landscape at golden hour",
    aspect_ratio=AspectRatio.WIDE,
    style=ImageStyle.CINEMATIC,
    quality=ImageQuality.HD,
)
img.save("wallpaper.png")

# Phone wallpaper (9:16)
img = ai.generate_image(
    "Futuristic city at night",
    aspect_ratio=AspectRatio.PORTRAIT,
    style=ImageStyle.RENDER_3D,
)
img.save("phone_bg.png")

# Batch generation (4 images in parallel)
images = ai.generate_image("A dragon", n=4)
for i, img in enumerate(images):
    img.save(f"dragon_{i:02d}.png")
```

### Aspect Ratios
- `1:1` (Square) - Default
- `16:9` (Wide) - Cinematic
- `9:16` (Portrait) - Phone
- `4:3`, `3:4` - Classic photo
- `21:9` - Ultrawide
- `3:2`, `2:3` - DSLR

### Styles
Auto, Photorealistic, Digital Art, Anime, Oil Painting, Watercolor, 3D Render, Pixel Art, Sketch, Cinematic, Fantasy

### Quality
Standard (fast), HD (detailed), Ultra (maximum)

## 🤖 Custom Agents

Create AI agents with custom personas. **Stored locally** for privacy.

```python
# Create
agent_id = ai.create_agent(
    name="Python Expert",
    description="Senior Python developer",
    system_prompt="You are a senior Python developer with 20 years of experience..."
)

# Use
response = ai.chat_with_agent(agent_id, "Explain decorators")

# List
agents = ai.list_custom_agents()

# Update
ai.update_agent(agent_id, description="Updated!")

# Delete
ai.delete_agent(agent_id)
```

**Storage**: `~/.aimind/custom_agents.json` (local only, no cloud)

## 🩺 Health Checks

```python
# Quick ping (~1s)
report = ai.ping()
print(f"Status: {report['status']}, Latency: {report['latency_ms']}ms")

# Full diagnostics (parallel, ~10s)
report = ai.ping(test_models=True, test_image=True)

for model_id, m in report["models"].items():
    print(f"  {m['status']:8} {m['latency_ms']:7}ms  {model_id}")
```

## 📊 Built-in Agents (27)

**Health & Wellness**
- `fitness-coach`, `wellness-guide`, `nutritionist`, `meditation-guide`

**Professional**
- `financial-advisor`, `business-consultant`, `career-coach`, `marketing-specialist`
- `productivity`, `resume-reviewer`, `interview-prep`, `sales-coach`

**Technical**
- `coding-mentor`, `data-analyst`, `math-tutor`, `research-assistant`
- `study-helper`, `legal-assistant`

**Creative**
- `creative`, `writing-coach`, `ux-designer`, `language-teacher`, `travel-planner`

**Support**
- `customer-support`, `relationship-advisor`, `parenting-coach`

##  Privacy

- ✅ **Local storage only** - Custom agents in `~/.aimind/`
- ✅ **No cloud sync** - Data never leaves your machine
- ✅ **No telemetry** - Zero usage tracking
- ✅ **No accounts** - No registration required
- ✅ **Full control** - You own all your data

## 📚 Documentation

- `README.md` - This file
- `IMAGE_GEN_GUIDE.md` - Image generation details
- `CUSTOM_AGENTS_GUIDE.md` - Custom agent creation
- `CURRENT_MODELS_2026.md` - Current AI models available
- `DUCKAI_INTEGRATION.md` - Duck.ai comparison & info

##  Comparison: AIMind vs Duck.ai

| Feature | AIMind | Duck.ai |
|---------|--------|---------|
| **Models** | 7 | 6 |
| **API Access** | ✅ Python | ❌ Web-only |
| **Image Gen** | ✅ Full control | ✅ Basic |
| **Custom Agents** | ✅ Local | ❌ No |
| **Memory** | ✅ Full | ❌ Limited |
| **Privacy** | ✅ Local | ✅ Anonymous |
| **Programming** | ✅ Full | ❌ Manual |

**Duck.ai**: Great for casual chat, visit https://duck.ai/  
**AIMind**: Best for developers, full API control

##  Requirements

- Python 3.7+
- requests>=2.28.0
- aiohttp>=3.8.0

##  License

MIT License - see LICENSE file

##  Support

- **Telegram**: [@glitchyapi](https://t.me/glitchyapi)
- **Email**: glitchyapi@gmail.com
- **PyPI**: https://pypi.org/project/aimind/

---

**Built with ❤️ by the GlitchyAPI Team**
