Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/linuztx/imageine

A Streamlit-powered web app that combines AI-assisted prompt improvement with image generation. Create detailed images from your ideas using Zephyr-7b-Beta and an external image API.
https://github.com/linuztx/imageine

image-generator llm python streamlit

Last synced: 24 days ago
JSON representation

A Streamlit-powered web app that combines AI-assisted prompt improvement with image generation. Create detailed images from your ideas using Zephyr-7b-Beta and an external image API.

Host: GitHub
URL: https://github.com/linuztx/imageine
Owner: linuztx
License: mit
Created: 2024-07-10T04:46:13.000Z (7 months ago)
Default Branch: main
Last Pushed: 2024-08-04T10:42:36.000Z (6 months ago)
Last Synced: 2024-11-10T11:03:45.029Z (3 months ago)
Topics: image-generator, llm, python, streamlit
Language: Python
Homepage: https://imageine.streamlit.app/
Size: 7.81 KB
Stars: 3
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# 🎨 AI Image Generator

[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://streamlit.io)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![OpenAI](https://img.shields.io/badge/OpenAI-API-green.svg)](https://openai.com/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Transform your text descriptions into stunning visuals using AI technology.

![imageine](https://github.com/user-attachments/assets/fea57fac-8586-4f25-aaae-058e414fe685)

## 🚀 Demo

Visit live demo at: [AI Image Generator Demo](https://imageine.streamlit.app/)

## ✨ Features

### 🎯 Core Features
- **AI-Powered Image Generation**: Create stunning visuals using any OpenAI Compatible image model
- **Smart Prompt Enhancement**: Improve your prompts with any OpenAI Compatible chat model
- **Real-time Processing**: Watch your ideas come to life instantly

### 💫 User Experience
- **Intuitive Interface**: Clean, modern design with responsive layout
- **Progress Tracking**: Real-time generation progress indicators
- **Quick Actions**: One-click download and regeneration options

### 🛠️ Technical Features
- **OpenAI Integration**: Leverages latest AI models
- **Docker Support**: Easy deployment with containerization

## 📦 Installation

### Prerequisites
- Python 3.9+
- OpenAI API key
- Docker (optional)

### Quick Start
```bash
# Clone the repository
git clone https://github.com/linuztx/imageine.git

# Navigate to project directory
cd imageine

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your API keys

# Run the application
streamlit run main.py
```

### 🐳 Docker Installation
```bash
# Build the image
docker build -t imageine .

# Run the container
docker run -p 8501:8501 imageine
```

## 🎯 Usage

### Basic Usage
1. Enter your image description
2. (Optional) Enable prompt enhancement
3. Click "Generate Image"
4. Download or regenerate as needed

### 🎨 Writing Effective Prompts
- Be specific about desired elements
- Include style preferences
- Mention lighting and composition
- Reference artistic influences

### ⚙️ Configuration
```env
# Chat Generation API
AI_CHAT_ENDPOINT=your-chat-generation-endpoint
AI_CHAT_API_KEY=your-chat-api-key

# Image Generation API
AI_IMAGE_ENDPOINT=your-image-generation-endpoint
AI_IMAGE_API_KEY=your-image-api-key

# Model
AI_CHAT_MODEL=your-model-here
AI_IMAGE_MODEL=your-image-model-here
```

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 💝 Donations

If you find this project useful, consider supporting my work by making a donation. Every contribution helps me continue developing and maintaining this project.

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/linuztx)

---