eclips-blossom-ai 0.4.4

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

🌸 Blossom AI

A beautiful Python SDK for Pollinations.AI

Generate images, text, and audio with AI - beautifully simple.

🚀 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

🚀 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)

📊 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                │
│  ✓ 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

🌟 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")

💬 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")

🔊 Audio Generation Examples

# Text-to-speech
ai.audio.save("Hello, world!", "greeting.mp3")

🤝 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

📄 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