Logo de Lucia Lucia
Login Register

Installation

Lucia is distributed as ready-to-use packages for Windows, Linux, and macOS. No source compilation required.

System requirements

  • Python 3.10+ (recommended: 3.11 or 3.12)
  • Terminal access (Linux, macOS, or Windows)
  • Node.js in PATH as node — optional, only needed when targeting JavaScript output (recommended: Node 20 LTS or 22 LTS)

Steps

Windows (includes Lucia + Editor)

  1. Download Lucia.zip from the download page.
  2. Extract the ZIP to a folder of your choice (for example, C:\Lucia).
  3. Open the extracted folder and run the installer/start script included in the package.
  4. Verify the installation by opening a terminal and running:
lucia --version

Linux (includes Lucia + Editor)

  1. Download LuciaCommunity-linux-basic-0.1.0.tar.gz from the download page.
  2. Extract the archive:
tar -xzf LuciaCommunity-linux-basic-0.1.0.tar.gz
cd LuciaCommunity-linux-basic-0.1.0
  1. Run the installation script included in the package:
chmod +x install.sh
./install.sh
  1. Verify the installation:
lucia --version

macOS (Lucia + Editor)

  1. Download LuciaSuite-basic-0.1.0.pkg from the download page.
  2. Double-click the .pkg file and follow the installation wizard.
  3. Verify the installation:
lucia --version

Next step

With Lucia installed, head over to CLI to learn how to run your first program.