src/image_captioning_app/README.md

---
title: BLIP Image Captioner
emoji: 🚀
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: "5.42.0"
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

# Image Captioning App (Deployable Package)

This packages your image captioning Gradio app so you can install and run it via a console command locally and deploy on Hugging Face Spaces.

## Local install (editable)

```bash
python -m pip install -U pip
pip install -e .
```

## Local run

```bash
image-caption
# or
python app.py
```

The Gradio UI will open on http://127.0.0.1:7860.

## Notes

- Torch wheels are large; for CUDA, install via the PyTorch site after the editable install.
- Add any extra libs your app needs to `requirements.txt` (for Spaces) and to `pyproject.toml` (for local package installs).