func-to-web 1.0.1

Transform any Python function into a web interface automatically

Func To Web 1.0.1

Type hints → Web UI. Minimal-boilerplate web apps from Python functions.

Two use cases: standalone utilities (internal tools, admin panels, scripts) with no frontend, and adding isolated Python features to existing web apps (e.g. "Export to PDF" button, CSV importer). Write a typed function, embed via iframe or call over HTTP, and skip the routes, validation, and form code.

Quick start

pip install func-to-web

from func_to_web import run

def divide(a: float, b: float):
    return a / b

run(divide)

Open http://127.0.0.1:8000. Done.

Full docs with examples and screenshots: offerrall.github.io/FuncToWeb

Inputs

Type	Widget	Docs
int, float	Number / slider	→
str, Email	Text / textarea / password	→
bool	Toggle	→
date, time	Pickers	→
Color	Hex picker	→
File, ImageFile, VideoFile, ...	Upload	→
Literal, Enum, Dropdown(func)	Select	→
list[T]	Dynamic list	→
T | None	Toggle + input	→
Params	Reusable groups	→
Annotated[T, ...]	Constraints, labels, sliders	→

Outputs

Return type	Rendered as	Docs
str, int, float, None	Text + copy button	→
PIL Image, Matplotlib Figure	Inline image	→
FileResponse	Download button	→
DataFrame, list[dict], ...	Sortable table + CSV	→
ActionTable	Clickable rows → next function	→
tuple / list	Multiple outputs	→
print()	Streamed live	→

Features

• Multiple functions with index page or groups — docs
• URL prefill — open forms with values from query params — docs
• Embed mode — drop any form into your site via ?__embed=1 — docs
• Auto-generated API docs at /doc for scripts and AI agents — docs
• Authentication with username/password — docs
• Dark mode — docs
• Server config — host, port, reverse proxy — docs

Examples

File transfer

from func_to_web import run, File
import shutil, os

downloads = os.path.expanduser("~/Downloads")

def upload_files(files: list[File]):
    for f in files:
        shutil.move(f, downloads)
    return "Done."

run(upload_files)

QR code generator

import qrcode
from func_to_web import run

def make_qr(text: str):
    return qrcode.make(text).get_image()

run(make_qr)

Protected admin panel

import subprocess
from typing import Literal
from func_to_web import run

def restart_service(service: Literal['nginx', 'gunicorn', 'celery']):
    subprocess.run(["sudo", "supervisorctl", "restart", service], check=True)
    return f"{service} restarted."

run(restart_service, auth={"admin": "your_password"})

More in examples/ and examples/apps/ — including a full CRUD app in 70 lines using Params + ActionTable.

Install

pip install func-to-web                                     # stable
pip install git+https://github.com/offerrall/FuncToWeb.git  # latest

Requirements: Python 3.10+. Core deps installed automatically; Pillow, Matplotlib, Pandas, NumPy and Polars are optional.

Built on pytypeinput and pytypeinputweb, usable standalone for CLIs, Qt apps, etc.

Feedback, issues and contributions welcome — they keep the project moving.

MIT License · Made by Beltrán Offerrall