In this example, we will cover how to develop and run a small webapp based on on FastAPI.

Let's start by creating a package for our app: Create a directory named example_fastapi and an empty file named __init__.py file within the directory.

example_fastapi/
example_fastapi/__init__.py

The copy the example from the FastAPI tutorial in __init__.py:

from typing import Optional

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def index():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: Optional[str] = None):
    return {"item_id": item_id, "q": q}

Install the FastAPI library and Uvicorn:

pip install fastapi uvicorn

Uvicorn is used to run ASGI compatible web applications, such as the app web application from the example above. You need to specify it the name of the Python module to use and the name of the app:

uvicorn example_fastapi:app --reload

Then open the app in a web browser on http://localhost:8000

Tip: With --reload, Uvicorn will automatically reload your code upon changes

The same app we just used with Gunicorn can be used by Aleph to run the web app, since Aleph attempts to be compatible with ASGI.

To achieve this, we need to follow the following steps:

zip -r example_fastapi.zip example_fastapi

You can use aleph-client to achieve this. See examples/store.py.

See this example.

In the code section, replace the ref with the item_hash of the messages storing your code.

Update the entrypoint field according to your app if necessary.

Open the HTTP interface of a node running the VM Supervisor:

http://ip-of-supervisor:4020/vm/{message_hash}/