https://github.com/tonykipkemboi/streamlit-replicate-img-app
Using Replicate to build Streamlit app for image generations!
https://github.com/tonykipkemboi/streamlit-replicate-img-app
imagegeneration python replicate streamlit
Last synced: 4 months ago
JSON representation
Using Replicate to build Streamlit app for image generations!
- Host: GitHub
- URL: https://github.com/tonykipkemboi/streamlit-replicate-img-app
- Owner: tonykipkemboi
- License: mit
- Created: 2023-07-31T21:03:57.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-14T19:25:04.000Z (about 1 year ago)
- Last Synced: 2025-06-20T05:45:06.584Z (4 months ago)
- Topics: imagegeneration, python, replicate, streamlit
- Language: Python
- Homepage: https://generateimages.streamlit.app/
- Size: 9.33 MB
- Stars: 97
- Watchers: 5
- Forks: 237
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ✨ Image Generation App ✨
[](https://github.com/tonykipkemboi/streamlit-replicate-img-app/actions/workflows/python-app.yml)
_Image Generator App: where art meets algorithms and dreams meet pixels!_ 🚀
## Overview
Powered by cutting-edge AI models running on [Replicate](https://replicate.com/about) and wrapped in a Streamlit interface, this app lets you transform plain text prompts into mesmerizing visual masterpieces.
## Technical Features
- **Neural Model**: Leverages the power of the replicate.run model for image generation, providing detailed and accurate depictions.
- **Streamlit Framework**: Built atop the versatile Streamlit library, ensuring a smooth and responsive UI/UX.
- **Dynamic Customization**: You can peek "under the hood", tune hyperparameters like guidance_scale, prompt_strength, and more for fine-grained control.
- **Gallery**: A curated gallery for inspiration, showcasing the prowess of the underlying model.
## Getting Started
1. Clone the repository:
```bash
git clone https://github.com/tonykipkemboi/streamlit-replicate-img-app.git
```
2. Navigate to the project directory:
```bash
cd streamlit-replicate-img-app
```
3. Install the dependencies:
```python
pip install -r requirements.txt
```
4. Rename the `.streamlit/example_secrets.toml` file to `.streamlit/secrets.toml`.
5. Paste your Replicate API token in the secrets.toml file:
```bash
REPLICATE_API_TOKEN = "paste-your-replicate-api-token-here"
```
## Usage
1. Run the Streamlit app:
```python
streamlit run streamlit_app.py
```
2. Navigate to the provided local URL, and voila! Start crafting your visual narratives.
## Contributions
Your insights can make this tool even better! Feel free to fork, make enhancements, and raise a PR.
## Attribution
- **Developed by**: The wizards over at [Stability AI](https://stability.ai/) 🧙♂️
- **Model type**: Diffusion-based text-to-image generative model
- **License**: [CreativeML Open RAIL++-M License](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/main/LICENSE.md)
- **Model Description**: This is a model that can be used to generate and modify images based on text prompts. It is a [Latent Diffusion Model](https://arxiv.org/abs/2112.10752) that uses two fixed, pretrained text encoders ([OpenCLIP-ViT/G](https://github.com/mlfoundations/open_clip) and [CLIP-ViT/L](https://github.com/openai/CLIP/tree/main)).
- **Resources for more information**: Check out our [GitHub Repository](https://github.com/Stability-AI/generative-models) and the [SDXL report on arXiv](https://arxiv.org/abs/2307.01952).