GitHub

Installation

Stable The installation process is stable across macOS, Linux, and Windows WSL.

Quick Install (Recommended)#

The fastest way to install Levython is with the one-line installer:

curl -fsSL https://raw.githubusercontent.com/levython/levython/main/install.sh | bash

The installer automatically:

  • Detects your operating system (macOS, Linux, Windows WSL)
  • Downloads and compiles Levython with optimal flags
  • Installs to ~/.levython/bin
  • Adds Levython to your PATH
  • Installs the LPM package manager

Manual Installation#

For more control over the installation process:

git clone https://github.com/levython/Levython.git
cd Levython
chmod +x install.sh
./install.sh

What Gets Installed#

The installer creates the following structure:

~/.levython/
โ”œโ”€โ”€ bin/
โ”‚   โ”œโ”€โ”€ levython    # Main interpreter with JIT
โ”‚   โ””โ”€โ”€ lpm         # Package manager
โ””โ”€โ”€ packages/       # Installed packages

System Requirements

  • macOS: 10.15+ (Catalina or later)
  • Linux: Any modern distribution with GCC
  • Windows: WSL (Windows Subsystem for Linux)

Post Installation#

After installation, restart your terminal or source your shell configuration:

source ~/.zshrc
source ~/.bashrc

Verify Installation#

Check that Levython is correctly installed:

levython --version
# Output: Levython 1.0.0

Run a quick test:

echo 'say("Hello from Levython!")' | levython -
# Output: Hello from Levython!

Uninstallation#

To completely remove Levython:

rm -rf ~/.levython

Then remove the PATH entry from your shell configuration file (~/.zshrc or ~/.bashrc).

Next Steps: Now that Levython is installed, check out the Quick Start guide to write your first program.