#6666th of 70 in Open models

joycaption

Llama 3.1-based image captioning VLM for building diffusion training datasets

Stars
1.3k
License
Apache-2.0
Last commit
Feb 2026
Language
Jupyter Notebook
Stars, last 29 weeks+181
21 Apr 2026: 1,120 stars28 Apr 2026: 1,125 stars5 May 2026: 1,129 stars12 May 2026: 1,138 stars19 May 2026: 1,143 stars26 May 2026: 1,154 stars2 Jun 2026: 1,163 stars9 Jun 2026: 1,170 stars16 Jun 2026: 1,173 stars23 Jun 2026: 1,187 stars30 Jun 2026: 1,193 stars7 Jul 2026: 1,199 stars14 Jul 2026: 1,200 stars21 Jul 2026: 1,207 stars28 Jul 2026: 1,211 stars4 Aug 2026: 1,215 stars11 Aug 2026: 1,219 stars18 Aug 2026: 1,223 stars25 Aug 2026: 1,232 stars1 Sept 2026: 1,239 stars8 Sept 2026: 1,244 stars15 Sept 2026: 1,252 stars22 Sept 2026: 1,261 stars29 Sept 2026: 1,264 stars6 Oct 2026: 1,269 stars13 Oct 2026: 1,273 stars20 Oct 2026: 1,280 stars27 Oct 2026: 1,286 stars3 Nov 2026: 1,297 stars10 Nov 2026: 1,301 stars

1,120 on 21 Apr 20261,301 on 10 Nov 2026

From GitHub's daily star counts.

Checked on GitHub.

Overview

JoyCaption is an open-weight vision-language model built on Llama 3.1 that writes captions for images, aimed at preparing diffusion model training data. It supports prompt modes such as descriptive, straightforward, Stable Diffusion and MidJourney prompts, and Danbooru, e621 and Rule34 tag lists. The repo holds usage examples (Transformers, vLLM) and finetuning scripts; the current model is Beta One.

Who it is for: People building image datasets for diffusion model training or finetuning

Strengths

  • Covers SFW and NSFW content, unlike the censored captioners it is compared against
  • Eleven prompt modes, including booru tag lists and Stable Diffusion prompt styles
  • Serves through vLLM with an OpenAI-compatible API
  • Includes finetuning scripts and a ComfyUI node with 8-bit and 4-bit support

Weaknesses

  • Needs about 17GB VRAM at bfloat16; lower memory requires quantization
  • Glitches on 1.5 to 3% of outputs, such as repetition loops
  • Tag-list modes (Danbooru, e621, Rule34) have lower accuracy than caption modes
  • Not a general instruction follower; left/right and OCR errors are expected

What it needs

  • GPU required
  • Needs PyTorch, Hugging Face Transformers, vLLM (optional)
  • Models: Llama 3.1 LLaVA-style HF checkpoint (bfloat16), 8-bit and 4-bit quantization

Quick answers

Is joycaption open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Can you run joycaption with Docker?

Yes. Its repository has a Docker setup: a Dockerfile, a Compose file or a published image.

Does joycaption need a GPU?

Yes, it needs a GPU.

Also in Open models

See all 70
Also in Open models
RankProjectScore
1ruviewWiFi CSI sensing on ESP32 for presence, breathing, heart rate and pose104k starsMIT94 out of 100
2layaSingle-pass multilingual classifier for typed choice, score and yes/no decisions Live demo ↗ (opens in a new tab)35.4k stars+3,167 (+9.8%) in 30 daysApache-2.088 out of 100
3rf-detrReal-time transformer models for object detection, segmentation and keypoints Live demo ↗ (opens in a new tab)10k starsApache-2.079 out of 100
#4timesfmPretrained time-series foundation model for zero-shot forecasting from Google Research35.4k stars+1,231 (+3.6%) in 30 daysApache-2.078 out of 100
#5yolov5PyTorch YOLOv5 object detection, segmentation and classification models with training code58.3k starsAGPL-3.076 out of 100