Repository navigation
Release v0.1.0
app-runtime v0.1.0
2026-10-26. The first release of the Python base runtime that runs lake Apps. Image: oramasearch/app-runtime:v0.1.0
(private). Every Lake runs Apps on it, through the operator's apps runtime image.
What it includes
Everything in the runtime, as of this release:
- Loading an App (Loading an App):
- The source comes from
APP_SOURCE=<lake_url>|<repository>|<revision>|<path>, orLAKE_URL,APP_REPOSITORY,
APP_REVISIONandAPP_PATH, with the read-only bearer token inAPP_TOKEN. - The pinned tree is read through lake's
repository_treeandrepository_fileand written below/tmp. app.toml(name,framework,entrypoint,port,dependencies,bindings) is validated without installing
anything.- A declared dependency is accepted when it is installed and satisfies its specifier; URL requirements are always
refused (#6). - An App baked into the image loads too (#8).
- The source comes from
- Frameworks (Frameworks and health):
- FastAPI (
module:object), whose lifespan runs inside the runtime (#10). - Streamlit (a Python script) on loopback, behind the runtime's proxy for HTTP and WebSocket.
- Static (a content directory with HTML index support).
/healthzand/readyzon the public port for every framework;APP_PORToverrides the manifest port (default
8080).- The App root stays on Python's module path for handler-time imports.
- FastAPI (
- Streamlit stream fix (#17, issue #16):
- The runtime relays Streamlit's WebSocket only when its
Originnames the host it was sent to, and gives Streamlit
its own loopback origin. - Streamlit starts with
--browser.serverAddress=127.0.0.1. - Before this, a Streamlit App behind its public host answered 500. Streamlit made a blocking external IP lookup that
a pod without internet egress waits on, and then refused the stream (403).
- The runtime relays Streamlit's WebSocket only when its
- Bindings and data Apps (
orama_appand bindings):- Binding JSON at
/var/run/orama/bindings/zettaand/var/run/orama/bindings/services/<name>, parsed in the
operator's exact Zetta binding shape (#15, lake#1205). - The
orama_apppackage:zetta()for governed workspace SQL, datasets, runs, models and scoring;service(name)
for a Service's connection fields; request-localcurrent_user()forauth: lake(bare user id accepted, #4).
- Binding JSON at
- Image: Python 3.12, UID 10001, App code below
/tmp(works with a read-only root filesystem), the pinned baked
set (FastAPI, Uvicorn, Streamlit, pandas, NumPy, Plotly, HTTPX, Pydantic, Jinja). - Example:
examples/data-dashboard, a Streamlit App over a fakeable Zetta
binding.
Not included
- No framework other than FastAPI, Streamlit and static.
- No installing of dependencies at startup: Apps that need more use image mode (lake's
build_app).
Known issues (security first)
- #13 (LSR-182, low): on a Public App, the runtime
reads identity headers (X-Orama-Userand the like) that the client supplied. A Public App's ingress does not
overwrite them, socurrent_user()can name someone who did not sign in. The fix also needs the operator. Until then,
onlyauth: lakeApps can rely oncurrent_user(). - #12: the pre-launch security review's other findings for the
runtime.
Where it has run
Every Lake ran oramasearch/app-runtime:976e6a8 (this code before #15 and #17) until this release. v0.1.0 rolls to
dev, testing, staging and production through the apps.runtimeImage of lake-nonprod and lake-prod.
Verification
| Proof | Result |
|---|---|
Full suite (uv run pytest, macOS) |
21 passed, 0 failed, 0 skipped |
| The Streamlit stream test | fails on 976e6a8's proxy (stream rejected), passes with #17; a page during the stream answers in under 2 s |
| Version test | tests/test_release.py reads the version from pyproject.toml and requires this page |
| Image | built from the tag on the cluster BuildKit (linux/amd64) |