1# modal
2
3run python functions on cloud GPUs with [modal](https://modal.com) on sublimated. write a `_run.py`, click run, get results back in your folder.
4
5## how it works
6
7- create a folder and add a `_run.py` file — sublimated detects it as a programmable folder
8- `_run.py` reads files from the folder, processes them, writes output files back
9- click the run button on any function in the toolbar — runs on Modal with GPU/CPU as configured
10- output files appear in your folder automatically via git push
11
12## what's supported
13
14- any python code (pandas, PIL, matplotlib, torch, etc)
15- GPU acceleration (T4, A10G, A100, H100) via modal decorators
16- custom pip dependencies via `requirements.txt`
17- multiple functions per file (each gets its own run button)
18- automatic file I/O — your code reads/writes files in the current directory
19- output files pushed back to your folder after execution
20- real-time status via activity indicators
21
22## demos
23
24working examples with source files:
25
26- [csv-analysis](csv-analysis/) — reads CSV files, produces summary stats and pivot tables
27- [image-resize](image-resize/) — creates thumbnails and contact sheets from images
28- [json-to-chart](json-to-chart/) — generates PNG bar charts from JSON data
29
30## guide
31
32step-by-step tutorial: [guide](guide.md)
33
34---
35
36[faq](../faq.md) · [all docs](../)