Installation

Hachi currently has a very lightweight installation process. There are no heavy runtime dependencies or large external framework requirements. Since Hachi is built on top of C++, getting started mainly requires a working C++ toolchain.

At this time, the standard setup expects:

  • clang++
  • make

Hachi has been tested successfully on Linux. Support for macOS and Windows has not yet been fully validated, so Linux is currently the recommended environment.

Quick Install

For a faster setup, you can use the install script:

curl -fsSL https://hdev.run/install | bash

This is the quickest way to get Hachi installed and ready to use on supported systems.

Requirements

Before building Hachi manually, make sure the following tools are installed:

  • clang++
  • make
  • git

You can verify your compiler is available with:

clang++ --version

Install on Linux

Install the required build tools:

apt install -y clang make git

Clone the Hachi repository:

git clone https://gitlab.com/hachi-lang/hachi

Enter the project directory:

cd hachi

Build Hachi:

make

Once the build completes successfully, the hachi compiler should be available in the project directory.

Compiling a Hachi Program

To compile a Hachi source file into a native executable, use:

hachi <your-program> -build <your-output-program-name>

Example

Given a source file named sk.8, you can compile it like this:

hachi sk.8 -build skate

Then run the compiled program:

./skate

Notes

  • Hachi source files commonly use the .8, .hachi, and .🐺 file extensions
  • The -build flag compiles your Hachi program into a native executable
  • A working C++ compiler is required because Hachi builds through a C++ compilation path
  • Linux is the primary tested platform at this time

Current Platform Status

Hachi installation and build workflows have been tested on Linux.

Installation has not yet been fully tested on:

  • macOS
  • Windows

Those platforms may work partially or with some adjustment, but Linux is currently the most reliable environment for development and use.