Fractal Lite

Warning

This project is a proof of concept (POC). It is experimental, unstable, and not intended for production use.

This project contains two main components:

• fractal-lite: A minimalistic implementation of fractal core concepts (datasets, collection, tasks, workflows, projects, history) without need of a database.
• A desktop app built with pywebview that serves a Svelte frontend and provides native file dialogs via a Python bridge.

Requirements

• pixi
• Node.js 18+ and npm

Setup

Run these three steps once after cloning.

1. Vendor the fractal-web component library

pixi run clone-fractal-web
cd fractal-web-clone/components && npm install --omit=peer

2. Build the frontend SPA

pixi run build-frontend

Running

Launch the native desktop window:

pixi run app

Or run the API server only (serves the built frontend at http://127.0.0.1:8765):

pixi run serve

To open a previously saved project:

pixi run app --open demo.flp

Build executable

To generate multi-platform single executable files, run the following command after building the frontend:

pixi run build-executable

Generated executables are located in the dist folder.

Development

Tests

pixi run -e dev test           # full test suite
pixi run -e dev test-fast      # skip slow e2e tests

Linting

pixi run -e dev lint

License

BSD 3-Clause — see LICENSE.