Spaces:
Running
Running
| title: README | |
| emoji: 📚 | |
| colorFrom: red | |
| colorTo: indigo | |
| sdk: static | |
| pinned: false | |
| # UV Scripts | |
| **Ready-to-run ML tools powered by UV - zero setup, maximum power** | |
| Run state-of-the-art ML workflows with a single command. From OCR to classification, all scripts work instantly with `uv run`. | |
| ## What are UV scripts? | |
| UV scripts are self-contained Python scripts that use [inline metadata](https://docs.astral.sh/uv/guides/scripts/) to specify dependencies. Just `uv run script.py` and everything installs automatically. | |
| Perfect for: | |
| - 🚀 **GPU workflows** on [HF Jobs](https://huggingface.co/docs/huggingface_hub/guides/jobs) | |
| - 💻 **Local processing** on your machine | |
| - 🔄 **Reproducible pipelines** that work anywhere | |
| ## 🚀 Quick Example | |
| ```bash | |
| # Extract text from images with state-of-the-art OCR (no local GPU needed!) | |
| hf jobs uv run --flavor l4x1 \ | |
| https://huggingface.co/datasets/uv-scripts/ocr/raw/main/nanonets-ocr.py \ | |
| your-images your-extracted-text | |
| ``` | |
| ## 📚 Browse Scripts | |
| | Script Collection | Description | GPU Required | | |
| | ------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------ | | |
| | [ocr](https://huggingface.co/datasets/uv-scripts/ocr) | Extract text from images with VLMs (LaTeX, tables, forms) | ✅ | | |
| | [classification](https://huggingface.co/datasets/uv-scripts/classification) | Text classification with guaranteed valid outputs | ✅ | | |
| | [dataset-creation](https://huggingface.co/datasets/uv-scripts/dataset-creation) | Create datasets from PDFs and files | ❌ | | |
| | [vllm](https://huggingface.co/datasets/uv-scripts/vllm) | High-performance inference with vLLM | ✅ | | |
| ## 🎯 Why UV Scripts? | |
| ### Zero Setup | |
| No virtual environments, no dependency conflicts, no installation steps. UV handles everything automatically when you run the script. | |
| ### GPU Optimized | |
| Seamlessly run on local GPUs or scale to cloud with [HF Jobs](https://huggingface.co/docs/huggingface_hub/guides/jobs). Same script, different compute. | |
| ## 🌟 Featured Scripts | |
| ### OCR Any Document Dataset | |
| Extract text from images with state-of-the-art accuracy: | |
| ```bash | |
| # Handles LaTeX, tables, forms, handwriting | |
| hf jobs uv run --flavor l4x1 \ | |
| https://huggingface.co/datasets/uv-scripts/ocr/raw/main/nanonets-ocr.py \ | |
| your-images extracted-text | |
| ``` | |
| ### Classify with Guaranteed Valid Outputs | |
| Text classification that always returns valid labels: | |
| ```bash | |
| # Uses vLLM's structured generation - no invalid outputs! | |
| hf jobs uv run --flavor l4x1 \ | |
| https://huggingface.co/datasets/uv-scripts/classification/raw/main/classify-dataset.py \ | |
| --input-dataset imdb --column text \ | |
| --labels "positive,negative" --output-dataset imdb-classified | |
| ``` | |
| ## 🚀 Getting Started with HF Jobs | |
| Run any UV script on GPU infrastructure: | |
| ```bash | |
| hf jobs uv run --flavor l4x1 \ | |
| https://huggingface.co/datasets/uv-scripts/[collection]/raw/main/[script].py \ | |
| [args] | |
| ``` | |
| Choose your GPU flavor: | |
| - `l4x1` - Good balance for most tasks | |
| - `a10g-large` - More memory for larger models | |
| - `a100-large` - Maximum performance | |
| ## 📖 Learn More | |
| - [UV Documentation](https://docs.astral.sh/uv/) | |
| - [HF Jobs Guide](https://huggingface.co/docs/huggingface_hub/guides/jobs) | |
| - [Script Examples](https://github.com/astral-sh/uv/tree/main/scripts) | |
| --- | |
| _UV Scripts is a community project showcasing the power of [UV](https://github.com/astral-sh/uv) for ML workflows._ | |