formless 0.3.0

Handwritten + image OCR.

formless

Handwritten + image OCR.

Usage

Hit the API:

curl -X POST -H "Content-Type: application/json" -d '{"image_url": "<image-url>"}' https://andrewhinh--formless-api-model-infer.modal.run

Or use the CLI:

uv run formless -i <image-url> [-v]

Soon:

• Python bindings.
• Frontend.

Development

Set Up

Set up the environment:

uv sync --all-extras --dev
uv run pre-commit install
modal setup

Repository Structure

.
├── api                 # API.
├── frontend            # frontend.
├── src/formless        # python bindings.
├── training            # training.

API

Run the API:

modal run api/app.py

Deploy:

modal deploy api/app.py

Frontend

Run the web app:

modal serve frontend/app.py

Deploy:

modal deploy frontend/app.py

PyPI

Run the package:

uv run formless -v

Build the package:

uvx --from build pyproject-build --installer uv

Upload the package:

uvx twine upload dist/*

Test the uploaded package:

uv run --with formless --no-project -- formless -v

Training

Run ETL on HF dataset:

modal run ft/etl.py

Train the model:

modal run ft/train_modal.py