---
title: README
emoji: 📚
colorFrom: red
colorTo: indigo
sdk: static
pinned: false
---

# UV Scripts

**Run ML workflows on GPU with a single command - no setup required**

Self-contained Python scripts powered by [UV](https://docs.astral.sh/uv/guides/scripts/) and [HF Jobs](https://huggingface.co/docs/huggingface_hub/guides/jobs). Pick a task, copy the command, and you're running on cloud GPUs in seconds.

## Get Started

```bash
hf jobs uv run --flavor l4x1 \
  https://huggingface.co/datasets/uv-scripts/ocr/raw/main/nanonets-ocr.py \
  your-images your-extracted-text
```

One command, no setup. Works locally too with just `uv run`.

## Browse Scripts

**Document Processing**
- [ocr](https://huggingface.co/datasets/uv-scripts/ocr) - Extract text from images with VLMs (LaTeX, tables, forms, handwriting)
- [dataset-creation](https://huggingface.co/datasets/uv-scripts/dataset-creation) - Create HF datasets from PDFs and local files (CPU only)

**Computer Vision**
- [sam3](https://huggingface.co/datasets/uv-scripts/sam3) - Zero-shot object detection with natural language prompts using SAM3

**Text Generation & Classification**
- [vllm](https://huggingface.co/datasets/uv-scripts/vllm) - High-performance GPU inference with vLLM (classification, VLM tasks)
- [classification](https://huggingface.co/datasets/uv-scripts/classification) - Text classification with structured outputs and guaranteed valid labels
- [openai-oss](https://huggingface.co/datasets/uv-scripts/openai-oss) - Generate responses using OpenAI's open-source reasoning models
- [synthetic-data](https://huggingface.co/datasets/uv-scripts/synthetic-data) - Generate synthetic training data with chain-of-thought reasoning

**Model Training**
- [unsloth/jobs](https://huggingface.co/datasets/unsloth/jobs) - Fine-tune LLMs and VLMs with Unsloth (LFM2.5, Qwen3-VL, Gemma3, continued pretraining)

**Analysis & Visualization**
- [dataset-stats](https://huggingface.co/datasets/uv-scripts/dataset-stats) - Analyze dataset statistics with streaming and Polars (CPU only)
- [build-atlas](https://huggingface.co/datasets/uv-scripts/build-atlas) - Generate interactive embedding visualizations with Apple's Atlas

## Learn More

- [HF Jobs Documentation](https://huggingface.co/docs/hub/jobs) - run `hf jobs hardware` to see available GPUs and pricing
- [Available GPU hardware](https://huggingface.co/docs/hub/en/spaces-gpus#hardware-specs)
- [UV Script Documentation](https://docs.astral.sh/uv/guides/scripts/)