AIMind - Universal AI Interface

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

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

pip install aimind

Quick Start

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

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.

# 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

# 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

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
• Email: glitchyapi@gmail.com
• PyPI: https://pypi.org/project/aimind/

Built with ❤️ by the GlitchyAPI Team