Skip to content

[BUG] Demo example fails to run on ARM processor runnung WSL2 (linux-aarch64): #873

@dlarussa

Description

@dlarussa

On a ARM64 machine running Windows 11, in WSL2 running Ubuntu-24.04 (4-May-2026):

> pixi init
> pixi add python python-fasthtml
> pixi shell
> python app.py
Traceback (most recent call last):
  File "/home/fizzix/repos/sandbox/fasthtml/app.py", line 3, in <module>
    app = FastHTML()
  File "/home/fizzix/repos/sandbox/fasthtml/.pixi/envs/default/lib/python3.14/site-packages/fasthtml/core.py", line 536, in __init__
    super().__init__(debug, routes, middleware=middleware, exception_handlers=excs, on_startup=on_startup, on_shutdown=on_shutdown, lifespan=lifespan)
    ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
TypeError: Starlette.__init__() got an unexpected keyword argument 'on_startup'
# Contents of app.py:
from fasthtml.common import FastHTML, serve

app = FastHTML()

@app.get("/")
def home():
    return "<h1>Hello, World</h1>"

serve()

Expected behavior
Server launches; demo app available on localhost.

Environment Information

> print(fastlite.__version__)
0.0.13
> print(fastcore.__version__)
1.12.44
> print(fasthtml.__version__)
0.9.1

Confirmation
Please confirm the following:

  • I have read the FAQ (https://docs.fastht.ml/explains/faq.html)
  • I have provided a minimal reproducible example
  • I have included the versions of fastlite, fastcore, and fasthtml
  • I understand that this is a volunteer open source project with no commercial support.

Additional context
I prefer to use pixi instead of pip for project environment management. I figured that was within scope given it's well-suited for managing AI libraries,

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions