HPCompiler Installation

Before installing HPCompiler, make sure that JDK 21 or later and Python 3.10 or later are installed on your system.

You can verify the installed versions from a PowerShell terminal:

Windows System

1. Verify Java and Python

Open a PowerShell terminal and run:

java --version
python --version

You should see output similar to:

java 21.0.2 2024-01-16 LTS
Java(TM) SE Runtime Environment (build 21.0.2+13-LTS-58)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.2+13-LTS-58, mixed mode, sharing)

Python 3.13.1

If the python command is not available but Python was installed with the Windows Python Launcher, you can also try:

py --version

2. Download HPCompiler

Download HPCompiler-v5.11.1 and save the ZIP file in any directory, for example:

C:\Users\<user>\Downloads

3. Uncompress HPCompiler

You can extract the ZIP file using Windows File Explorer or PowerShell.

For example:

cd C:\Users\<user>\Downloads
Expand-Archive .\hpcompiler-v5.11.1.zip -DestinationPath .

4. Change to the HPCompiler directory

Run:

cd .\hpcompiler-v5.11.1

5. Check the distribution files

Run:
ls

You should see files and directories similar to:

    Directory: C:\Users\rhp7m\Downloads\hpcompiler-v5.11.1
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----       02/09/2026     11:57                bin
d-----       02/09/2026     11:57                lib
-a----       01/09/2026     20:18          36950 hp
-a----       30/08/2026     23:32            595 hp.bat
-a----       01/09/2026     20:48          36764 hp.py
-a----       01/12/2025     14:25         603493 hplang-1.0.0.vsix
-a----       01/09/2026     19:48           4088 install_hpcompiler.ps1
-a----       02/03/2026     19:15           2774 install_hpcompiler.sh
-a----       25/05/2026     20:55           2633 install_hpcompiler_server.sh
-a----       02/03/2026     19:17             16 requirements.txt

6. Install HPCompiler

Run:

powershell.exe -ExecutionPolicy Bypass -File .\install_hpcompiler.ps1

HPCompiler is installed in your user home directory:

C:\Users\<user>\hpcompiler

Each HPCompiler version has its own directory and its own private Python virtual environment:

C:\Users\<user>\hpcompiler\
└── versions\
    ├── hpcompiler-v5.11.1\
    │   ├── bin\
    │   ├── lib\
    │   └── venv\
    │
    └── current

The current directory references the active HPCompiler version.

The installer also adds the following directory to the user PATH:

C:\Users\<user>\hpcompiler\versions\current\bin

The installation does not modify the system PATH and does not require administrator privileges.

During installation, you should see messages similar to:

HPCompiler Installer
====================

Installing version hpcompiler-v5.11.1...

Creating Python virtual environment...
Installing HPCompiler Python dependencies...
Collecting colorama>=0.4.6 (from -r C:\Users\rhp7m\Downloads\hpcompiler-v5.9.0\requirements.txt (line 1))
  Using cached colorama-0.4.6-py2.py3-none-any.whl.metadata (17 kB)
Using cached colorama-0.4.6-py2.py3-none-any.whl (25 kB)
Installing collected packages: colorama
Successfully installed colorama-0.4.6

Updating current version...
Current version set to hpcompiler-v5.11.1.
User PATH already contains HPCompiler.

Installation completed successfully.

Open a new terminal and run:
    hp --version
    hpcompiler --version

HPCompiler installs its Python dependencies inside the private virtual environment associated with that HPCompiler version. It does not install these dependencies into the global Python environment.

7. Close the terminal

Close the PowerShell terminal used during installation.

You do not need to restart Windows.

8. Open a new PowerShell terminal

Create a working directory for your HPLang programs, for example:

mkdir hp_prgs

    Directory: C:\Users\rhp7m
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----       02/09/2026     12:08                prgs
cd hp_prgs

9. Verify the HPCompiler installation

Run:

hp --version

hp v1.20.0 (Ocober 2, 2026)
hpcompiler --version

HPCompiler 5.11.1 (October 21, 2026)

You can also verify the HPCompiler environment (in this case all are ok) with:

hp doctor

Running environment diagnostics ...

[OK] HPCompiler Python 3.14.6
Info           /Users/roberto/hpcompiler/versions/hpcompiler-v5.10.0/venv/bin/python
[OK] User Python 3.14.6
Info           /Library/Frameworks/Python.framework/Versions/3.14/bin/python3
[OK] cs 9.0.305
Info           /usr/local/bin/dotnet
[OK] PHP 8.4.4
Info           /usr/local/bin/php
[OK] Java 21.0.2
Info           /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home/bin/java
[OK] HPCompiler 5.11.0
Info           /Users/roberto/hpcompiler/versions/current/bin/hpcompiler
[OK] config.hp

Diagnostic finished.

and check the installed HPCompiler versions with:

hp list

Installed versions:
    hpcompiler-v5.8.1
    hpcompiler-v5.9.0
    hpcompiler-v5.10.0
    hpcompiler-v5.11.0
  * hpcompiler-v5.11.1 (current)

10. Run your first HPLang program

You can compile and run an HPLang program, for instance, MyProgram.hp with:

hp MyProgram.hp

You can also run:

hp

When no filename is specified, HPCompiler uses the default TestLang.hp program.

The first time a working directory is used, HPCompiler initializes the workspace and then compiles and runs the program.

You should see output similar to:

Configuring this working space (directory) for hpcompiler.

Compiling TestLang.hp for python ...
Running with Python ...
HP Language.
Version 5.11.1 (October 29, 2026)

That's all. Good luck.