Downloads · 30 days
0
joy-caption-pre-alpha
Wi-zz/joy-caption-pre-alpha
joy-caption-pre-alpha is a machine learning model from Wi-zz. Use it for the machine learning task on the model card, and read the license before you ship it in a product.
This application generates descriptive captions for images using advanced ML models. It processes single images or entire directories, leveraging CLIP and LLM models for accurate and contextual captions. It has NSFW c…
Access
Public
Updated Aug 29, 2024
Repo size
2 GB
Likes
95
Public
Repo makeup
Click a slice to open those files.
.pt86 MB · 100%
At a glance
- Access
- Public
- Created
- Aug 25, 2024
- Updated
- Aug 29, 2024
- SHA
- 3bce52e2
Model card
From the Hugging Face model README
Image Captioning App
Overview
This application generates descriptive captions for images using advanced ML models. It processes single images or entire directories, leveraging CLIP and LLM models for accurate and contextual captions. It has NSFW captioning support with natural language. This is just an extension of the original author's efforts to improve performance. Their repo is located here: https://huggingface.co/spaces/fancyfeast/joy-caption-pre-alpha.
Features
- Single image and batch processing
- Multiple directory support
- Custom output directory
- Adjustable batch size
- Progress tracking
Usage
| Command | Description |
|---|---|
python app.py image.jpg | Process a single image |
python app.py /path/to/directory | Process all images in a directory |
python app.py /path/to/dir1 /path/to/dir2 | Process multiple directories |
python app.py /path/to/dir --output /path/to/output | Specify output directory |
python app.py /path/to/dir --bs 8 | Set batch size (default: 4) |
Technical Details
- Models: CLIP (vision), LLM (language), custom ImageAdapter
- Optimization: CUDA-enabled GPU support
- Error Handling: Skips problematic images in batch processing
Requirements
- Python 3.x
- PyTorch
- Transformers library
- CUDA-capable GPU (recommended)
Installation
Windows
git clone https://huggingface.co/Wi-zz/joy-caption-pre-alpha
cd joy-caption-pre-alpha
python -m venv venv
.\venv\Scripts\activate
# Change as per https://pytorch.org/get-started/locally/
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt
Linux
git clone https://huggingface.co/Wi-zz/joy-caption-pre-alpha
cd joy-caption-pre-alpha
python3 -m venv venv
source venv/bin/activate
pip3 install torch torchvision torchaudio
pip3 install -r requirements.txt
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License.
- Created
- Aug 25, 2024
- Updated
- Aug 29, 2024