DOCS/GETTING STARTED/INSTALLATION

Chapter 02

Install and run.

Set up the engine, verify the command-line interface and execute your first Block program.

PLATFORMWINDOWS x64VERSION2.2.2TIME~5 MIN
02.1

Before you begin

The guided setup is designed for Windows. Ensure you can install applications and update the user or system PATH.

Windows 10 / 1164-bit environment
Installation accessPermission to write application files
Runtime availabilityDepends on the selected edition
02.2

Use the guided installer

  1. 01

    Download Block Setup

    Get the self-contained installation package from the download center.

    Download BlockSetup-v2.2.2.exe ↓
  2. 02

    Choose an edition

    Select Lite, Standard or Block+ according to the runtimes your project needs.

  3. 03

    Complete environment setup

    Allow the installer to place the engine and register the block command. Restart the terminal after setup.

Runtime packages can vary by edition.

Block+ may require additional native toolchains. Review the install summary before confirming changes.

02.3

Verify the command

Open a new Command Prompt or PowerShell window and run:

Terminal
block --version

A successful installation reports the engine version and selected edition.

EXPECTED OUTPUTBlock Language Engine v2.2.2 / Standard EditionVERIFIED
02.4

Essential commands

block script.blk

Execute a Block program.

block --version

Show version and edition information.

block --help

Display usage and available commands.

block workspace show

Inspect project and workspace search roots.

block find [name]

Find a script without scanning the entire drive.

block project run

Run the entry declared by the nearest project manifest.

block serve [port]

Start the built-in HTTP server.

block config

Open interactive engine settings.

block-plus check script.blkp

Run Block+ cross-language checks.

02.5

Run your first program

Create hello.blk and add two native runtime stages.

hello.blk
<py>
greeting = "Hello from Python"
numbers = [1, 2, 3, 4]
</py>

<js>
console.log(greeting);
console.log(numbers.map(value => value * 2));
</js>
Run
block hello.blk
02.5

Stop changing directories

For a project created with block ecosystem init, Block discovers main.blk from child directories. For several projects, set one workspace root:

Project discovery
block project root
block project run

block workspace set C:\BlockProjects
block workspace show
block find analytics

When more than one script matches, Block reports the candidates instead of choosing randomly. Use an absolute path for intentional disambiguation.