eclips-blossom-ai 0.4.6

🌸 Beautiful and simple AI generation library for images, text, and audio

🌸 Blossom AI

🚀 Quick Start • 📚 Documentation • 💡 Examples • 📝 Changelog

---

✨ Features

🖼️ Image Generation Create stunning images from text Direct URL generation (no downloads!) Save to file or get raw bytes	📝 Text Generation Multiple AI models support Real-time streaming Timeout protection	🎙️ Audio Generation Text-to-speech conversion Multiple voice options High-quality output
🚀 Unified API Sync & async support Consistent interface Easy to learn	🧹 Clean Code Proper resource management Automatic cleanup Type hints included	⚡ Fast & Reliable Optimized performance Error handling Production-ready

🆕 What's New in v0.4.5

🔧 Production Improvements

Performance:

• ⚡ 100x faster import time (5s → 50ms)
• 🧠 Smart model caching with 5-minute TTL
• 📉 19x less memory usage in long-running apps

Reliability:

• ✅ Integration tests with VCR.py
• 🔄 Intelligent retry with API-specified delays
• 🛡️ Better error handling and recovery

Security:

• 🔐 Tokens now only in headers (never in URLs)
• ✅ SSL certificate verification enforced
• 🔒 No token exposure in logs or browser history

See CHANGELOG for details

🚀 Quick Start

📦 Installation

pip install eclips-blossom-ai

⚡ Basic Usage

from blossom_ai import Blossom

with Blossom() as ai:
    # Generate image URL (Fast & Free!)
    url = ai.image.generate_url("a beautiful sunset")
    print(url)
    
    # Save image directly to a file
    ai.image.save("a serene lake at dawn", "lake.jpg")

    # Get raw image bytes for custom processing
    image_bytes = ai.image.generate("a robot painting a portrait")
    # Now you can upload, display, or manipulate image_bytes as needed

    # Generate text
    response = ai.text.generate("Explain quantum computing")
    print(response)

    # Stream text
    for chunk in ai.text.generate("Tell me a story", stream=True):
        print(chunk, end='', flush=True)

🔐 Production-Ready Setup

import os
from blossom_ai import Blossom

# ✅ Best practice: Use environment variables
api_token = os.getenv('POLLINATIONS_API_KEY')

# ✅ Always use context managers
with Blossom(api_version="v2", api_token=api_token) as ai:
    # Your code here
    image = ai.image.generate(
        "a sunset",
        quality="hd",
        nologo=True
    )
# Automatic cleanup - no resource leaks!

📊 Why Blossom AI?

┌─────────────────────────────────────────────────────────┐
│  ✓ Unified API for image, text, and audio generation   │
│  ✓ Both sync and async support out of the box          │
│  ✓ Clean, modern Python with type hints                │
│  ✓ Production-ready with comprehensive testing         │
│  ✓ Active development and community support            │
└─────────────────────────────────────────────────────────┘

📚 Documentation

Resource	Description
📖 Getting Started	Complete guide to using Blossom AI
⚙️ Installation	Setup and configuration instructions
💡 Examples	Practical code examples and use cases
🆕 V2 API Guide	Migrate to V2 API with new features
📝 Changelog	Version history and updates
🔒 Security	Security best practices

🌟 Showcase

🎨 Image Generation Examples

# Generate artistic images
ai.image.save("a cyberpunk city at night", "cyberpunk.jpg")
ai.image.save("watercolor painting of mountains", "mountains.jpg")

# V2 API: HD quality with advanced controls
with Blossom(api_version="v2", api_token="token") as ai:
    image = ai.image.generate(
        "majestic dragon",
        quality="hd",
        guidance_scale=7.5,
        negative_prompt="blurry, low quality"
    )

💬 Text Generation Examples

# Creative writing
story = ai.text.generate("Write a short sci-fi story")

# Code generation
code = ai.text.generate("Create a Python function to sort a list")

# V2 API: Advanced controls
with Blossom(api_version="v2", api_token="token") as ai:
    response = ai.text.generate(
        "Explain AI",
        max_tokens=200,
        frequency_penalty=0.5,
        temperature=0.8
    )

📊 Audio Generation Examples

# Text-to-speech (requires API token)
with Blossom(api_token="your_token") as ai:
    ai.audio.save("Hello, world!", "greeting.mp3", voice="nova")

🛡️ super update

Blossom AI v0.4.5 best is with:

✅ Comprehensive Testing: Integration tests with VCR.py
✅ Memory Safe: No memory leaks in long-running applications
✅ Secure: Tokens only in headers, SSL verification enforced
✅ Fast: Optimized caching and connection pooling
✅ Reliable: Smart retry logic with exponential backoff

Quick Health Check

from blossom_ai import Blossom

# Verify everything works
def health_check():
    try:
        with Blossom(api_version="v2", api_token="token") as client:
            # Test image
            img = client.image.generate("test", width=256, height=256)
            assert len(img) > 1000
            
            # Test text
            txt = client.text.generate("Say hello", max_tokens=10)
            assert len(txt) > 0
            
            print("✅ Health check passed!")
            return True
    except Exception as e:
        print(f"❌ Health check failed: {e}")
        return False

health_check()

🤝 Contributing

Contributions are what make the open-source community amazing! Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

📄 License

Distributed under the MIT License. See LICENSE for more information.

💖 Support

If you find this project helpful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting new features
• 📢 Sharing with others

---

Made with 🌸 and ❤️ by Eclips Team

⬆️ Back to top