Installing Quetzal Language

This guide will walk you through the process of installing the Quetzal Language interpreter on Windows.

Windows Only

System Requirements

Operating System

• Windows 10 (64-bit) or later
• Windows 11 (recommended)

Minimum Hardware

• RAM: 512 MB minimum (1 GB recommended)
• Storage: 100 MB free space
• Processor: x64 compatible

Step-by-Step Installation

1. Download the executable

   Go to the GitHub releases page and download the latest version:

   • Quetzal Language Releases
   • Look for the file named quetzal.exe in the Assets section of the latest release.

2. Create installation directory

   Create a folder for Quetzal on your system. We recommend:

   C:\quetzal\

   Move the downloaded quetzal.exe file to this folder.

3. Configure environment variables

   To run Quetzal from any location:

   • Press Win + R, type sysdm.cpl and press Enter
   • Go to the “Advanced” tab
   • Click on “Environment Variables”
   • In “System variables”, find the Path variable and click “Edit”
   • Click “New” and add the path: C:\quetzal
   • Click “OK” on all windows

4. Verify the installation

   Open a new Command Prompt or PowerShell window and run:

   quetzal --version

   You should see something like:

   Lenguaje Quetzal v0.0.2

Basic Usage

Run a Quetzal file

quetzal my_program.qz

View help

quetzal --ayuda

Quick Verification

Create a file named test.qz with the following content:

// Test file to verify installation
consola.mostrar_exito("Quetzal Language installed successfully!")

entero edad = 25
texto nombre = "Maria"

consola.mostrar("Hola " + nombre + ", tienes " + edad.texto() + " anos")

si (edad >= 18) {
    consola.mostrar("Eres mayor de edad")
} sino {
    consola.mostrar("Eres menor de edad")
}

Run the file:

quetzal test.qz

If you see the correct output, the installation was successful!

Troubleshooting

Command not recognized

Error: 'quetzal' is not recognized as an internal or external command

Solution:

• Verify you added the correct path to PATH
• Restart Command Prompt/PowerShell after changing environment variables
• Make sure the file is at C:\quetzal\quetzal.exe

Permission error

Error: Cannot execute the file

Solution:

• Run Command Prompt as administrator
• Verify you have read permissions on the installation folder
• Make sure Windows is not blocking the file (right-click > Properties > Unblock)

Antivirus blocks the file

Error: Antivirus detects the file as a threat

Solution:

• Add C:\quetzal\ to your antivirus exceptions
• Download again from the official GitHub Releases
• Report the false positive to your antivirus provider

Diagnostic Commands

# Verify the file exists
dir C:\quetzal\quetzal.exe

# Check environment variables
echo %PATH%

# Run with detailed information
quetzal --info

Updating Quetzal

To update to a new version:

1. Download the new quetzal.exe from GitHub Releases
2. Replace the previous file in C:\quetzal\
3. Verify the new version with quetzal --version

Uninstalling

To remove Quetzal from your system:

1. Delete the C:\quetzal\ folder
2. Remove C:\quetzal from the PATH environment variable
3. (Optional) Delete any .qz files you created

Next Steps

Great! You now have Quetzal Language ready to use. Continue with:

Your first program

Learn to create and run your first complete program in Quetzal.

Create first program

Basic syntax

Get familiar with the syntax and structure of the language.

Learn syntax

Practical examples

Explore code examples for different use cases.

View examples

---

Having trouble with installation? Report an issue on our GitHub repository.