Gecco Help

Gecco Installation Guide

This guide provides step-by-step instructions to install Gecco on Windows, Linux, and macOS. Whether you're a seasoned developer or new to programming, follow the appropriate section to set up Gecco on your system quickly.

Windows System Requirements

Before you begin, ensure your system meets the following minimum requirements:

  • Operating System: Windows 10 or later

  • RAM: 4 GB or more

  • Disk Space: 500 MB free space

  • Compiler: Dependencies: GCC 10+

Installation on Windows

  1. Download Gecco Installer:

    • Visit the official Gecco website

    • Navigate to the Windows section and select the Windows Installer.

  2. Run the Installer:

    • Double-click the installer file (GeccoSetup.exe).

    • Follow the on-screen instructions to complete the installation.

  3. Set Environment Variables:

    • During installation, the installer should add Gecco to your system’s PATH. If not:

    • Go to Control Panel > System > Advanced System Settings.

    • Click Environment Variables and add the Gecco installation directory (e.g., C:\Gecco) to the PATH variable.

  4. Verify Installation:

    • Open Command Prompt and run:

      gecco --version
    • You should see the installed version of Gecco.

Updating Gecco on Windows

To update to the latest version of Gecco:

  • Download the latest installer and follow the installation steps.

Uninstallation on Windows

  • Use the Add/Remove Programs feature in the Control Panel to uninstall Gecco.

macOS System Requirements

Before you begin, ensure your system meets the following minimum requirements:

  • Operating System: macOS 10.15 (Catalina) or later

  • RAM: 4 GB or more

  • Disk Space: 500 MB free space

  • Compiler: Dependencies: Clang 11+

Installation on macOS

  1. Install Homebrew (if not already installed):

  • Run the following command in Terminal:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Add the Gecco Formula

    • Add the official Gecco tap:

    brew tap gecco/tap
  2. Install Gecco

    • Run:

      brew install gecco
  3. Verify the Installation

    • Open Terminal and run:

      gecco --version

From Source

  1. Download the Source Code

    • Clone the repository:

      git clone https://github.com/GeccoLand/Gecco.git cd gecco
  2. Install Dependencies

    • Ensure Xcode command-line tools are installed:

      xcode-select --install
  3. Build Gecco

    • Run the build script:

      ./build.sh
  4. Install Gecco

    • Install the built binaries:

      sudo ./install.sh
  5. Verify the Installation

    • Run:

      gecco --version

Updating Gecco on macOS

  • Pull the latest changes from the repository and reinstall:

    cd gecco git pull origin main ./install.sh

Uninstallation on macOS

  • Remove the Gecco binary and related files:

    sudo rm -rf /usr/local/bin/gecco sudo rm -rf /usr/local/lib/gecco

Linux System Requirements

Before you begin, ensure your system meets the following minimum requirements:

  • Operating System: Linux distribution with a 64-bit kernel.

  • RAM: 4 GB or more

  • Disk Space: 500 MB free space

  • Compiler: Clang 11+

Installation on Linux

  1. Add the Gecco Repository

    • For Debian-based systems(e.g., Ubuntu):

      sudo add-apt-repository ppa:gecco/stable sudo apt update
    • For RPM-based systems (e.g., Fedora):

      sudo dnf config-manager --add-repo https://gecco.dev/repo/gecco.repo sudo dnf update
  2. Install Gecco

    • On Debian-based systems

      sudo apt install gecco
    • On RPM-based systems:

      sudo dnf install gecco
  3. Verify the Installation

    • Open a terminal and run:

      gecco --version
    • The installed version of Gecco should be displayed.

From the Source Code

  1. Download the Source Code

    • Clone the Gecco repository:

      git clone https://github.com/GeccoLand/Gecco.git cd gecco
  2. Build Gecco

    • Ensure you have Clang installed:

      sudo apt install build-essential
    • Run the build script:

      ./build.sh
  3. Install Gecco

    • Install the built binaries:

      sudo ./install.sh
  4. Verify the Installation

    • Run:

      gecco --version

Updating Gecco on Linux

  • Pull the latest changes from the repository and reinstall:

    cd gecco git pull origin main ./install.sh

Uninstallation on Linux

  • Remove the Gecco binary and related files:

    sudo rm -rf /usr/local/bin/gecco sudo rm -rf /usr/local/lib/gecco

For additional help, visit the Gecco Support Center or join our community forums.

Last modified: 19 December 2024