AIMind 🧠

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

✨ 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

pip install aimind

Basic Usage

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

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

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

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

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

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? Contact us on Telegram or email glitchyapi@gmail.com

---

Made with ❤️ by the GlitchyAPI Team

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

🚀 Smart Proxy Support (Unlimited Requests)

For unlimited AI requests via IP rotation:

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 (smart IP rotation)

Proxy Features:

# 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 smart IP rotation (rotating IPs)
• May be slower (proxy overhead)
• Requires internet connection

---

Made with ❤️ by the GlitchyAPI Team

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

🤝 Support

• Telegram: @glitchyapi
• Email: glitchyapi@gmail.com

📄 License

MIT License - see LICENSE file for details