wybthon

Wybthon

Build interactive web apps in Python, no JavaScript required.

Documentation · Getting Started · Examples · Contributing

Overview

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.

Features

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, and untrack, with automatic batching: writes apply immediately and effects run once per flush.
Async-first: Pass an async def to create_memo for async data; Loading boundaries show fallbacks, later refetches serve the stale value while revalidating, and action plus optimistic state cover mutations.
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, Link component, and programmatic navigation.
Context API: Share state across the component tree with create_context and use_context.
Forms and validation: Built-in form state management with validators and two-way bindings.
Flow control primitives: Show, For, Repeat, Switch, Match, and Dynamic for declarative rendering.
Error and loading boundaries: ErrorBoundary for graceful error handling and Loading for declarative async fallbacks.
Dev server with hot reload: wyb dev launches a local server with SSE-based auto-reload.

Quick Start

Installation

pip install wybthon

Usage

from 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`` is a reactive hole, so only the
    # text node inside the span updates when the signal changes.
    return div(
        p("Count: ", span(count)),
        button("Increment", on_click=lambda e: set_count(count() + 1)),
    )

Documentation

Visit wybthon.com for the full documentation, including getting started guides, core concepts, API reference, and working examples.

Contributing

Contributions are welcome. Please see CONTRIBUTING.md for setup instructions, coding standards, and guidelines for submitting pull requests.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wybthon-0.30.0.tar.gz (156.4 kB view details)

Uploaded Sep 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

wybthon-0.30.0-py3-none-any.whl (119.2 kB view details)

Uploaded Sep 1, 2026 Python 3

File details

Details for the file wybthon-0.30.0.tar.gz.

File metadata

Download URL: wybthon-0.30.0.tar.gz
Upload date: Sep 1, 2026
Size: 156.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wybthon-0.30.0.tar.gz
Algorithm	Hash digest
SHA256	`66d99809dcbd1c748d219a10344967f357bb323f9d0ab50064a9ea8258b216a1`
MD5	`5fff64454816f747c95928a299154847`
BLAKE2b-256	`6e7d3ce573b35513de8f4959da3ee4daeddbb64bf1bda5f1091303a01312fbaa`

See more details on using hashes here.

Provenance

The following attestation bundles were made for wybthon-0.30.0.tar.gz:

Publisher: release.yml on wybthon/wybthon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: wybthon-0.30.0.tar.gz
- Subject digest: 66d99809dcbd1c748d219a10344967f357bb323f9d0ab50064a9ea8258b216a1
- Sigstore transparency entry: 2671621329
- Sigstore integration time: Sep 1, 2026
Source repository:
- Permalink: wybthon/wybthon@892d94153f4e607a4b0e515fe3ff6311eb797dc1
- Branch / Tag: refs/heads/main
- Owner: https://github.com/wybthon
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@892d94153f4e607a4b0e515fe3ff6311eb797dc1
- Trigger Event: push