Installation

Get Logos up and running on your system in seconds.

Quick Install

The fastest way to install Logos is with our install script:

This script automatically detects your system and installs the appropriate binary.

Manual Installation

If you prefer to install manually, download the appropriate binary for your system:

Linux (amd64)

wget https://github.com/codetesla51/logos/releases/latest/download/logos-linux-amd64
chmod +x logos-linux-amd64
sudo mv logos-linux-amd64 /usr/local/bin/lgs

macOS (Apple Silicon)

curl -LO https://github.com/codetesla51/logos/releases/latest/download/logos-darwin-arm64
chmod +x logos-darwin-arm64
sudo mv logos-darwin-arm64 /usr/local/bin/lgs

macOS (Intel)

curl -LO https://github.com/codetesla51/logos/releases/latest/download/logos-darwin-amd64
chmod +x logos-darwin-amd64
sudo mv logos-darwin-amd64 /usr/local/bin/lgs

Build from Source

You can also build Logos from source if you have Go installed:

git clone https://github.com/codetesla51/logos.git
cd logos
go build -o lgs ./cmd/logos
sudo mv lgs /usr/local/bin/

Requirements

• Operating System: Linux or macOS
• Architecture: x86_64 (amd64) or ARM64
• Go (for building): 1.21 or later

Verify Installation

After installation, verify that Logos is working:

lgs --version

You should see the version number printed to the console.

Your First Script

Create a file called hello.lgs:

let name = "World"
print("Hello, " + name + "!")

Run it:

lgs hello.lgs

You should see Hello, World! printed to your terminal.

Interactive REPL

Logos includes an interactive REPL (Read-Eval-Print Loop) for experimenting with code. Just run lgs without any arguments:

lgs

This starts the interactive shell:

>_ Logos v0.0.1 (Mar 02 2026, 12:52:39) on linux
Type "help" for more information
>>>

From here you can type Logos expressions and see results immediately. Great for testing ideas and learning the language.