Overview

Lilush is a statically compiled for Linux LuaJIT runtime with a bundled collection of Lua modules and C libraries.

It comes in two flavors: slim lilu build, and a bigger one lilush build.

lilu — Static LuaJIT runtime with batteries

lilu is a minimal lilush build. It comes with

• File system operations and process manipulation

• TCP/UDP networking with TLS 1.3 support; HTTP(S) client, HTTP(S)/1.1 server

• Cryptography: hashing, HMAC, Ed25519, X.509

• Terminal I/O with UTF-8 support, widgets, styling with TSS (Terminal Style Sheets)

• Markdown processing/rendering

• MNEME embedded K/V database, supporting full text search and encryption at rest

• Redis & WireGuard clients

For networking, lilu uses LEV — a coroutine-based async I/O runtime built on Linux epoll with TLS 1.3 support via LITLS.

The binary is smaller than 2MB, and should work fine on any x86_64 Linux system.

lilush — Linux Lua Shell, Graphics & Audio engines

The full lilush build extends lilu with a modular Linux Shell (as in Bash, Csh or Fish). The shell is called Lilush Shell, and it

• is there to humour my whims and fancies

• provides a rather handsome CLI interface straight out of the box:

  • Pre-configured prompts: host, user, dir, git, python venv

  • Command completions, completions scrolling

  • Fast directory navigation and history search, similar to McFly and zoxide

  • Terminal graphics support

• has some handy shell builtins like kat (file viewer + pager), lem text editor, netstat, dig, wgcli, etc.

• is styled and themeable via TSS

• is easily extendable with plugins

• can do fortune telling and will probably one day save humanity

Besides shell the full lilush build includes graphics & audio engines, and can be used as a game engine framework.

Verify release signature

Lilush release binaries are signed with an SSH key (namespace=file). The signing key is published at deviant.guru/keys.

# Create allowed signers file with the release signing key
cat > allowed_signers <<'EOF'
vladimir@deviant.guru ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICEWU0xshVgOIyjzQEOKtjG8sU8sWJPh25CP/ISfJRey
EOF

# Verify signature
ssh-keygen -Y verify \
  -f allowed_signers \
  -I vladimir@deviant.guru \
  -n file \
  -s ${BINARY}.sig < ${BINARY}

If verification succeeds, ssh-keygen prints Good "file" signature for vladimir@deviant.guru ....

Each release directory also carries a signed SHA256SUMS:

curl -fLO "https://lilush.link/releases/latest/SHA256SUMS"
curl -fLO "https://lilush.link/releases/latest/SHA256SUMS.sig"
ssh-keygen -Y verify -f allowed_signers -I vladimir@deviant.guru \
  -n file -s SHA256SUMS.sig < SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS

chmod +x lilu
# Install system-wide:
sudo install -Dm755 lilu /usr/local/bin/lilu
# Or user install, make sure `~/.local/bin` is in your `PATH`
install -Dm755 lilu ~/.local/bin/lilu
# Use
lilu -e 'print("Hello from lilu!")'
lilu /path/to/my_script.lua

chmod +x lilush
# Install system-wide, in /usr/bin/:
sudo install -Dm755 lilush /usr/bin/lilush
# Or under `/usr/local/bin`
sudo install -Dm755 lilush /usr/local/bin/lilush
# or user install somewhere in your `PATH`...
# start Lilush Shell:
lilush

Building from source

See DEVELOPMENT.md

Documentation

Documentation Index references all documents available in the repository.

Documentation on core Lilush modules API:

• is available at Lilush API docs website

• available during runtime via wiki mode (F3) in Lilush Shell

See LIMAN for instructions on how to generate the runtime documentation database.