Build interactive web apps in Python, no JavaScript required.
Documentation · Getting Started · Examples · Contributing
Wybthon is a client-side SPA framework that lets you build interactive web applications entirely in Python. Powered by Pyodide, it runs in the browser and provides a signals-first reactive model inspired by SolidJS. With fine-grained reactivity, a virtual DOM, component model, routing, forms, and context, you can write modern frontends without touching JavaScript.
- Run-once components + reactive holes: function bodies run a single time at mount. Embed a signal getter anywhere in your VNode tree and the reconciler wires it as a reactive hole: only that DOM node updates when the signal changes. No React-style re-renders.
- Signals-first reactivity: Fine-grained updates with
create_signal,create_effect,create_memo,batch,untrack, andon. - Virtual DOM: Function components with efficient, batched diffing, amortising the Pyodide ↔ JS bridge cost while keeping SolidJS-style fine-grained updates above it.
- Client-side router: Path parameters, query parsing,
Linkcomponent, and programmatic navigation. - Context API: Share state across the component tree with
create_contextanduse_context. - Forms and validation: Built-in form state management with validators and two-way bindings.
- Flow control primitives:
Show,For,Index,Switch,Match, andDynamicfor declarative rendering. - Error boundaries and Suspense: Graceful error handling and async loading states.
- Dev server with hot reload:
wyb devlaunches a local server with SSE-based auto-reload.
pip install wybthonfrom wybthon import button, component, create_signal, div, p, span
@component
def Counter(initial: int = 0):
count, set_count = create_signal(initial)
# The body runs ONCE. ``count.get`` is a reactive hole, so only the
# text node inside the span updates when the signal changes.
return div(
p("Count: ", span(count.get)),
button("Increment", on_click=lambda e: set_count(count() + 1)),
)Visit wybthon.com for the full documentation, including getting started guides, core concepts, API reference, and working examples.
Contributions are welcome. Please see CONTRIBUTING.md for setup instructions, coding standards, and guidelines for submitting pull requests.