Skip to content

Releases

Release v0.2.0

Choose a tag to compare

@homer6 homer6 released this 16 Nov 07:33
918ebf1

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 to scratch or 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

Choose a tag to compare

@homer6 homer6 released this 27 Oct 18:53
cc813f8

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

Choose a tag to compare

@homer6 homer6 released this 27 Oct 02:08
883b827

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's contents text form writes every non-ASCII byte as literal \xNN text (lake#1238), so a production App's
    title showed \xF0\x9F\x91\xA5 for 👥. contents is 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

Choose a tag to compare

@homer6 homer6 released this 26 Oct 21:45
1806ea3

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() reads X-Orama-User (a bare id or a JSON object) only when APP_AUTH is exactly lake.
    • The operator sets APP_AUTH from the App's spec.auth (orama-operator#831,
      in v0.10.3).
    • On a Public App, an unset APP_AUTH or any other value, current_user() is None.
    • The unsigned fallbacks (X-Orama-User-Id, X-Orama-User-Email, X-Orama-User-Name, X-Auth-Request-*) are
      removed.
    • CurrentUserMiddleware strips forgeable identity headers before App code or Streamlit (HTTP and WebSocket) sees
      them.
    • ORAMA_CURRENT_USER is honoured only when APP_AUTH is 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

Choose a tag to compare

@homer6 homer6 released this 26 Oct 21:40
34c25d5

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>, or LAKE_URL, APP_REPOSITORY,
      APP_REVISION and APP_PATH, with the read-only bearer token in APP_TOKEN.
    • The pinned tree is read through lake's repository_tree and repository_file and 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).
  • 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).
    • /healthz and /readyz on the public port for every framework; APP_PORT overrides the manifest port (default
      8080).
    • The App root stays on Python's module path for handler-time imports.
  • Streamlit stream fix (#17, issue #16):
    • The runtime relays Streamlit's WebSocket only when its Origin names 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).
  • Bindings and data Apps (orama_app and bindings):
    • Binding JSON at /var/run/orama/bindings/zetta and /var/run/orama/bindings/services/<name>, parsed in the
      operator's exact Zetta binding shape (#15, lake#1205).
    • The orama_app package: zetta() for governed workspace SQL, datasets, runs, models and scoring; service(name)
      for a Service's connection fields; request-local current_user() for auth: lake (bare user id accepted, #4).
  • 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-User and the like) that the client supplied. A Public App's ingress does not
    overwrite them, so current_user() can name someone who did not sign in. The fix also needs the operator. Until then,
    only auth: lake Apps can rely on current_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)