Repository navigation
Releases
Release v0.2.0
Released 2026-11-16. A minor release, since v0.1.3: the repository is prepared for the Orama Lake open-source release. It is licensed MIT, has a security policy, pins its base images by digest, and its public tree carries nothing internal. The runtime's behaviour is unchanged from v0.1.3.
What it includes
| PR | Change |
|---|---|
| #31 | SECURITY.md: how to report a vulnerability privately, and what we commit to |
| #32 | The Dockerfile names its base images by multi-platform index digest as well as by tag, so a moved tag cannot change a later build of the same source |
| #33 | Internal material kept out of the public tree: a public CONTRIBUTING.md, and the published files rewritten to name nothing internal |
| #34 | MIT LICENSE and COPYRIGHT, an SPDX-License-Identifier: MIT line in every source file, THIRD_PARTY_LICENSES, CONTRIBUTING.md, CLA.md and CODE_OF_CONDUCT.md, and the software bill of materials (sbom.spdx.json, sbom.cdx.json, tools/sbom.py) |
| #37 | The Dockerfile has one pinned build stage again: a merge had left a second, unpinned one (#36) |
| this release | the version 0.2.0 and these notes; the SBOM regenerated |
What it does not include
- No pull request was open at the cut, so nothing was deferred.
- No change to how Apps are loaded or served.
Known issues
- The image is not published (#35, a release blocker for the open-source release). It is built on
python:3.12-slim(Debian), which bundles GPL and LGPL userland (glibc, bash, coreutils, dpkg, readline). It moves toscratchor another static base with static binaries before the image is made public. - Earlier known issues: as in v0.1.3.
Verification
| Proof | Result |
|---|---|
uv run pytest, Python 3.12 |
33 tests, all pass |
tools/spdx-headers.py --check |
passes |
tools/sbom.py --check |
passes, regenerated after the last change |
uv lock --check |
the lock file matches pyproject.toml |
Release v0.1.3
app-runtime v0.1.3
Released 2026-10-27. A patch release, with lake v0.8.1 (lake#1260):
Streamlit page updates over 1 MiB reach the browser. Since v0.1.2. Private repository and image, docker.io/oramasearch/app-runtime:v0.1.3.
What it includes
| PR | Change |
|---|---|
| #27 | The Streamlit proxy relays messages of any size from the App's Streamlit. A page update over 1 MiB (a large table or chart) closed the stream, so the page stopped updating and a sidebar filter seemed to do nothing (#26, agent-application#64). |
Known issues
As in v0.1.2.
Verification
- The repository's test suite on each pull request above, each with a regression test that fails on the old code; not
re-run on the release branch. - Image built from the tag on the cluster BuildKit; checked by lake v0.8.1's end-to-end gate on
lake-testing.
Release v0.1.2
app-runtime v0.1.2
2026-10-26. A patch on top of v0.1.1. Image: oramasearch/app-runtime:v0.1.2 (private).
What it changes
- Apps show non-ASCII text correctly (#22): the loader takes each file's bytes from Lake's
content_base64, which is
exact. Lake'scontentstext form writes every non-ASCII byte as literal\xNNtext (lake#1238), so a production App's
title showed\xF0\x9F\x91\xA5for 👥.contentsis used only when no base64 form is sent.
Known issues
- #12: the review's other findings.
Verification
| Proof | Result |
|---|---|
Full suite (uv run pytest) |
32 passed, 0 failed, 0 skipped |
| New test | an emoji, a middle dot and an accent arrive byte for byte from content_base64; contents alone still loads |
| Image | built from the tag on the cluster BuildKit (linux/amd64) |
Release v0.1.1
app-runtime v0.1.1
2026-10-26. A security fix on top of v0.1.0, released the same day, before v0.1.0 reached any cluster.
Everything in v0.1.0 is included. Image: oramasearch/app-runtime:v0.1.1 (private).
What it adds
- Identity only from Lake's forward auth (#14, fixes #13 / LSR-182 and #11):
current_user()readsX-Orama-User(a bare id or a JSON object) only whenAPP_AUTHis exactlylake.- The operator sets
APP_AUTHfrom the App'sspec.auth(orama-operator#831,
in v0.10.3). - On a Public App, an unset
APP_AUTHor any other value,current_user()isNone. - The unsigned fallbacks (
X-Orama-User-Id,X-Orama-User-Email,X-Orama-User-Name,X-Auth-Request-*) are
removed. CurrentUserMiddlewarestrips forgeable identity headers before App code or Streamlit (HTTP and WebSocket) sees
them.ORAMA_CURRENT_USERis honoured only whenAPP_AUTHis unset (local development).
Rollout order
The operator must set APP_AUTH before this runtime runs. Under an older operator, current_user() is None on every
App: it fails closed. Every cluster runs orama-operator v0.10.3, which sets it, and the live App pods carry
APP_AUTH=lake.
Known issues
- #12: the pre-launch security review's other findings for the
runtime.
Verification
| Proof | Result |
|---|---|
Full suite (uv run pytest, macOS) |
31 passed, 0 failed, 0 skipped |
| #14 after its rebase onto dev | 31 passed, including the Streamlit stream test from v0.1.0 |
| Version test | tests/test_release.py reads 0.1.1 from pyproject.toml and requires this page |
| Image | built from the tag on the cluster BuildKit (linux/amd64) |
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) |