Skip to content

strawlab/sunbeam

Repository files navigation

Sunbeam - Simple Jupyter Lab

The purpose of Sunbeam is to enable non-programmers to get started with Jupyter Lab on their own hardware. Users should not need to understand Python packages or how to use the command line to launch Jupyter Lab with a selection of software.

+ =

uv + jupyter lab = sunbeam

Sunbeam is a graphical user interface application to launch Jupyter Lab with package selection using uv.

Installation

Download the latest release for your platform from https://github.com/strawlab/sunbeam/releases

Screenshots

Screenshot of Main Window Screenshot of Process Output Screenshot of Configuration Preview

License

Copyright 2025 Andrew D. Straw

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Development

npm install
npm run tauri dev

Icon

The sun icon comes from lucide.

Update sidecar

Build universal uv binary on MacOS

UV_VERSION=0.9.9
curl --remote-name --location https://github.com/astral-sh/uv/releases/download/$UV_VERSION/uv-aarch64-apple-darwin.tar.gz
curl --remote-name --location https://github.com/astral-sh/uv/releases/download/$UV_VERSION/uv-x86_64-apple-darwin.tar.gz
tar xf uv-aarch64-apple-darwin.tar.gz uv-aarch64-apple-darwin/uv
tar xf uv-x86_64-apple-darwin.tar.gz uv-x86_64-apple-darwin/uv
mkdir -p src-tauri/binaries
mv uv-aarch64-apple-darwin/uv ./src-tauri/binaries/uv-aarch64-apple-darwin
mv uv-x86_64-apple-darwin/uv ./src-tauri/binaries/uv-x86_64-apple-darwin
lipo -create ./src-tauri/binaries/uv-aarch64-apple-darwin ./src-tauri/binaries/uv-x86_64-apple-darwin -output ./src-tauri/binaries/uv-universal-apple-darwin

Build for release

The releases we distribute are built with GitHub Actions, but you can build a release locally.

On MacOS, to build universal binary

(Requires rustup target add x86_64-apple-darwin)

npm run tauri build -- --target universal-apple-darwin