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: 3 months 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: other
- Created: 2024-07-10T04:46:13.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-17T09:29:44.000Z (over 1 year ago)
- Last Synced: 2025-06-12T14:50:34.100Z (12 months ago)
- Topics: image-generator, llm, python, streamlit
- Language: Python
- Homepage: https://imageine.streamlit.app/
- Size: 14.6 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎨 AI Image Generator
[](https://streamlit.io)
[](https://www.python.org/downloads/)
[](https://openai.com/)
[](https://opensource.org/licenses/MIT)
Transform your text descriptions into stunning visuals using AI technology.
## 🚀 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.
[](https://ko-fi.com/linuztx)
---
Made with ❤️ using Streamlit | © 2024 AI Image Generator