Auto-write captions for your photos using Hugging Face's free image captioning tool

Create a free Hugging Face account

Open your browser and go to huggingface.co. Look for a Sign up button or link, usually near the top-right of the page. Type your email, pick a password, and confirm your inbox when the verification email arrives.

A free account lets you try any of the public demos without hitting strict rate limits. The page should land on your profile or the home feed once you're done.

If it looks different: if you already have an account, click Log in instead of Sign up — and if your browser saved an old login, you may skip straight to the homepage.

You'll know it worked when you see your profile picture or initials in the top-right corner of the page.

Find an image captioning Space

From the top menu, click Spaces — think of a Space as a small web app built by someone in the Hugging Face community. In the search bar on the Spaces page, type image captioning and press Enter. You'll see a list of community-built demos; pick one with a clear name like BLIP Image Captioning or ViT-GPT2 Image Captioning.

Don't worry about picking the "best" one. Most of these demos do the same basic job: read your photo and write one sentence about it.

If it looks different: if the search bar isn't obvious, try the Filters button, choose the Computer Vision category, and scroll until you spot a captioning demo.

You'll know it worked when you land on a page whose title mentions "Image Captioning" and shows an upload area or a button that says something like "Upload" or "Drop an image here".

Open the demo and wait for it to load

Click on the chosen Space to open it. The first time you visit, the demo may take 10–30 seconds to wake up — this is normal, since free demos often go to sleep when no one is using them. A progress bar, a spinner, or words like "Running" or "Starting" usually appear while it loads.

Once it's ready, you'll see an upload area and, on most Spaces, a short blurb explaining what the model does.

If it looks different: if you only see a gray box for more than a minute, refresh the page once. If it still won't load, try a different captioning Space from the search results in Step 2.

You'll know it worked when the upload area becomes active — usually it says "Drop image here" or shows a small image icon.

Upload your first photo

Drag a single photo from your desktop into the upload area, or click the area to open a file picker and choose your picture. The photo appears as a small preview on the page. Don't upload dozens at once — most free demos are built to caption one image at a time.

Wait a few seconds. The caption will appear in a text box or label below the image.

If it looks different: if nothing happens after about 30 seconds, look for a Submit or Run button near the upload area — some Spaces require you to confirm the upload before they process it.

You'll know it worked when a short English sentence describing your photo appears in or near the upload area.

Try a few more photos to see the range

Pick 3–5 different photos — a landscape, a portrait, a pet, a city street, a close-up of food — and run them through the demo one at a time. This helps you see what the tool handles well and where it gets confused. You'll likely notice it's strong at obvious scenes (beaches, dogs, kitchens) and weaker at very specific or unusual images.

If it looks different: don't be surprised if the caption is generic ("a person standing outside") for busy scenes. That's the model playing it safe rather than guessing at details it can't see clearly.

You'll know it worked when you have a small list of captions that roughly match each photo's main subject.

Copy and store your captions

Highlight the caption text in the demo's output box and copy it with Ctrl+C on Windows or Cmd+C on Mac. Paste it into a notes app, a Google Doc, or a spreadsheet right next to the photo's filename. Repeat for each photo. There's no built-in batch export — the work is mostly copying and pasting one at a time.

If it looks different: if the caption text isn't selectable, right-click the output area and choose Copy from the menu instead.

You'll know it worked when you have a tidy list of one-line descriptions you can reuse later.

Use your captions in real life

Now do something useful with them. For social media posts, paste a caption under your photo and tweak the wording if you want more personality. For alt text (the short description screen readers use for images on websites), paste it directly into the image's alt-text field. For organizing your own photo library, drop the captions into a folder named "_captions.txt" so you can search them later.

If it looks different: alt-text fields look slightly different on every site — on a WordPress blog it's under "Image attributes", on X or Twitter it's the small alt field you fill in while uploading.

You'll know it worked when you stop staring at unlabeled photos thinking "what was this one again?"