Skip to content

Installing Grapa

Grapa is available as platform-specific packages with a universal installer that automatically detects your platform and downloads the appropriate package.

Note: Documentation and downloads are available on GitHub.

Grapa 0.1.53+ provides a universal installer that automatically detects your platform and downloads the correct package:

  • Smart platform detection - automatically identifies your system
  • Optimized packages - each platform gets only what it needs
  • Under 100MB - all packages stay well under GitHub's file size limit
  • Complete development kit - includes sample code, CMake build system, and all libraries
  • Self-contained - no external dependencies required

Quick Installation

# Download and run the universal installer
curl -O https://github.com/grapa-dev/grapa/releases/download/v0.1.53/install-grapa-0.1.53.py
python3 install-grapa-0.1.53.py

The installer will: 1. Detect your platform (macOS, Linux, Windows, AWS) 2. Download the appropriate package for your system 3. Install Grapa to ~/.local/grapa/ 4. Set up the environment for immediate use

Manual Installation (Alternative)

If you prefer to download and install manually, you can download the specific package for your platform:

macOS (ARM64 - Apple Silicon)

Download and install: 

# Download the macOS ARM64 package
curl -L -o grapa-0.1.53-mac-arm64.zip https://github.com/grapa-dev/grapa/releases/download/v0.1.53/grapa-0.1.53-mac-arm64.zip

# Extract the package
unzip grapa-0.1.53-mac-arm64.zip
cd grapa-0.1.53

# Run the installer
python3 install-grapa.py

# Verify installation
grapa --version

Test basic functionality: 

grapa -c "2+2"
grapa -c "'Hello World'.echo()"

Uninstall: 

# The installer provides uninstall instructions
# Or manually remove:
sudo rm -f /usr/local/bin/grapa
sudo rm -f /usr/local/lib/libgrapa_static.a
sudo rm -f /usr/local/lib/libgrapa.so

Linux (AMD64)

Download and install: 

# Download the Linux AMD64 package
wget https://github.com/grapa-dev/grapa/releases/download/v0.1.53/grapa-0.1.53-linux-amd64.zip

# Extract and install
unzip grapa-0.1.53-linux-amd64.zip
cd grapa-0.1.53
sudo python3 install-grapa.py

# Verify installation
grapa --version

Linux (ARM64)

Download and install: 

# Download the Linux ARM64 package
wget https://github.com/grapa-dev/grapa/releases/download/v0.1.53/grapa-0.1.53-linux-arm64.zip

# Extract and install
unzip grapa-0.1.53-linux-arm64.zip
cd grapa-0.1.53
sudo python3 install-grapa.py

# Verify installation
grapa --version

Test basic functionality: 

grapa -c "2+2"
grapa -c "'Hello World'.echo()"

Uninstall: 

# Remove from system directories
sudo rm -f /usr/local/bin/grapa
sudo rm -f /usr/local/lib/libgrapa_static.a
sudo rm -f /usr/local/lib/libgrapa.so

AWS (AMD64)

Download and install: 

# Download the AWS AMD64 package
wget https://github.com/grapa-dev/grapa/releases/download/v0.1.53/grapa-0.1.53-aws-amd64.zip

# Extract and install
unzip grapa-0.1.53-aws-amd64.zip
cd grapa-0.1.53
sudo python3 install-grapa.py

# Verify installation
grapa --version

AWS (ARM64)

Download and install: 

# Download the AWS ARM64 package
wget https://github.com/grapa-dev/grapa/releases/download/v0.1.53/grapa-0.1.53-aws-arm64.zip

# Extract and install
unzip grapa-0.1.53-aws-arm64.zip
cd grapa-0.1.53
sudo python3 install-grapa.py

# Verify installation
grapa --version

Test basic functionality: 

grapa -c "2+2"
grapa -c "'Hello World'.echo()"

Uninstall: 

# Remove from system directories
sudo rm -f /usr/local/bin/grapa
sudo rm -f /usr/local/lib/libgrapa_static.a
sudo rm -f /usr/local/lib/libgrapa.so

Windows (AMD64)

Download and install:

  1. Download the Windows package: 

    # Download the Windows AMD64 release
Invoke-WebRequest -Uri "https://github.com/grapa-dev/grapa/releases/download/v0.1.53/grapa-0.1.53-win-amd64.zip" -OutFile "grapa-0.1.53-win-amd64.zip"

  2. Extract the package: 

    Expand-Archive -Path "grapa-0.1.53-win-amd64.zip" -DestinationPath "grapa-0.1.53" -Force

  3. Run the installer (run PowerShell as Administrator): 

    cd grapa-0.1.53
python install-grapa.py

  4. Verify installation: 

    grapa --version

Test basic functionality: 

grapa -c "2+2"
grapa -c "'Hello World'.echo()"

Installation Location: After installation, Grapa will be available at: - Executable: C:\Program Files\Grapa\bin\grapa.exe - Static Library: C:\Program Files\Grapa\lib\grapa_static.lib - Shared Library: C:\Program Files\Grapa\lib\grapa.dll (if available) - PATH: Automatically added to system PATH for command-line access

Uninstall: 

# Run PowerShell as Administrator
python install-grapa.py --uninstall

🛠️ Building and Running the Example

The universal development kit includes a complete C++ example demonstrating how to embed Grapa in your applications.

Build the Example Application

After extracting the universal package, you can build and run the included example:

# Navigate to the extracted directory
cd grapa-0.1.53

# Create build directory
mkdir build && cd build

# Configure with CMake
cmake ..

# Build the project
cmake --build .

# Run the example
./grapa_example  # On Unix/macOS
grapa_example.exe  # On Windows

What the Example Demonstrates

The included main.cpp shows how to: - Initialize the Grapa runtime - Execute Grapa code from C++ - Handle errors and return values - Clean up resources properly

Development Workflow

The universal development kit supports the standard CMake workflow:

# Standard CMake build process
mkdir build && cd build
cmake ..
cmake --build .

This works consistently across all platforms (Windows, macOS, Linux) with the same commands.

Verify Installation

After installation, verify that Grapa is working correctly:

grapa --version

You should see output similar to: 

Grapa version 0.1.53

Test Basic Functionality

Try running a simple Grapa command:

grapa -c "2+2"
grapa -c "'Hello World'.echo()"

You should see: 

4
Hello World

🐍 Python Extension Build

Grapa 0.1.53 includes support for building Python extensions. If you need to build from source with Python support:

Build with Python Extension

# Build Grapa with Python extension support
python3 build.py --python

# On Windows, use:
python build.py --python

Install Python Extension

After building, install the Python extension:

Windows: 

# Upgrade pip first
pip install --upgrade pip

# Install GrapaPy
pip install grapapy==0.1.53

Non-Windows: 

# Upgrade pip first
pip3 install --upgrade pip

# Install GrapaPy
pip3 install grapapy==0.1.53

Verify Python Integration

import grapapy
g = grapapy.grapa()
result = g.eval('2 + 2')
print(f'Grapa result: {result}')

Available Packages

The platform-specific release provides optimized packages for each platform:

  • install-grapa-0.1.53.py - Universal Installer (4 KB)
  • Automatically detects your platform
  • Downloads the appropriate package
  • Installs Grapa with proper setup

Platform-Specific Packages: - grapa-0.1.53-mac-arm64.zip - macOS ARM64 (10.1 MB) - grapa-0.1.53-linux-amd64.zip - Linux AMD64 (13.0 MB) - grapa-0.1.53-linux-arm64.zip - Linux ARM64 (13.8 MB) - grapa-0.1.53-win-amd64.zip - Windows AMD64 (41.3 MB) - grapa-0.1.53-aws-amd64.zip - AWS AMD64 (12.4 MB) - grapa-0.1.53-aws-arm64.zip - AWS ARM64 (12.8 MB)

Each package includes: - Platform-specific Grapa executable - Universal installer (install-grapa.py) - Sample C++ application (main.cpp) - Complete CMake build system - Platform libraries and headers - Self-contained with no external dependencies

Troubleshooting

"grapa: command not found"

  1. Verify installation completed successfully: 

    # Check if grapa is installed
which grapa

# Check if it's executable
ls -la $(which grapa)

  2. Check if PATH is set correctly: 

    echo $PATH | grep "/usr/local/bin"

  3. Try restarting your terminal after installation.

Permission Denied

  1. Ensure you have appropriate permissions: 

    # Linux/macOS
sudo chmod +x /usr/local/bin/grapa

  2. Check file permissions: 

    # Linux/macOS
ls -la $(which grapa)

Windows-Specific Issues

Installation Script Issues

If the install-grapa.py script fails:

  1. Check Python installation: 

    python --version
# Should show Python 3.6 or higher

  2. Verify the script exists: 

    Test-Path "install-grapa.py"

  3. Run the script with verbose output: 

    python install-grapa.py --verbose

Python Installation Issues

If you encounter Python-related errors:

  1. Check Python installation: 

    python --version

  2. Install Python if needed:

  3. Download from python.org
  4. Make sure to check "Add Python to PATH" during installation

PATH Issues

If Grapa is installed but not found in PATH:

  1. Check if Grapa is in the installation directory: 

    Test-Path "C:\Program Files\Grapa\bin\grapa.exe"

  2. Add Grapa to PATH manually: 

    $env:PATH += ";C:\Program Files\Grapa\bin"

  3. Restart PowerShell to ensure PATH changes take effect.

Getting Help

If you encounter issues not covered here:

  1. Check the Troubleshooting Guide
  2. Search existing issues on GitHub
  3. Create a new issue with details about your platform and error messages

Next Steps

After successful installation:

  1. Read the Getting Started Guide for your first Grapa program
  2. Explore the CLI Quick Start for command-line usage
  3. Check out Examples for sample code and use cases