Skip to content

Latest commit

 

History

History
135 lines (95 loc) · 3.57 KB

getting-started.md

File metadata and controls

135 lines (95 loc) · 3.57 KB
description icon
Install Juvix in less than 5 minutes.
screwdriver-wrench

Getting Started

Juvix is Anoma's language for intent-centric and declarative decentralized applications.

Get started by installing Juvix in less than 5 minutes.

Installing Juvix

Please select from the options below to install the Juvix compiler on your system. We currently support

  • Linux x86_64
  • macOS x86_64 and aarch64 (M1/M2)

{% hint style="info" %} All example applications are currently compliant with the anoma-apps v0.2.0 release. {% endhint %}

{% stepper %} {% step %}

Prerequisites

The Juvix compiler requires the LLVM/clang compiler to be available on your system PATH in order to build native binaries.

{% tabs %} {% tab title="macOS" %} If you use the Homebrew package manager, you can install LLVM/clang via

brew update
brew install llvm

Alternatively, you can install the Xcode command line tools

xcode-select install

{% endtab %}

{% tab title="Linux" %} On Ubuntu/Debian, install clang via

sudo apt-get update
sudo apt install clang

On Arch Linux, install clang via

sudo pacman -Syu
sudo pacman -S clang

{% endtab %} {% endtabs %} {% endstep %}

{% step %}

Juvix Compiler

Next, you need to install the Juvix compiler.

{% tabs %} {% tab title="macOS" %} If you use the Homebrew package manager, you can use our tap:

brew update
brew tap anoma/juvix
brew install --overwrite juvix-nightly

Alternatively, you can download and unzip the compiler executable linked below

and move it to a directory on your shell's PATH (e.g., /usr/local/bin). {% endtab %}

{% tab title="Linux" %} Download and unzip the compiler executable linked below

and move it to a directory on your shell's PATH (e.g., /usr/local/bin). {% endtab %} {% endtabs %} {% endstep %}

{% step %}

IDE Setup

Lastly, you can set up the IDE of your choice.

{% tabs %} {% tab title="Visual Studio Code" %} First install visual studio code from the Microsoft website.

In the extension tab search for juvix and install the extension that features the Tara logo.

See the vscode-juvix repository for usage information. {% endtab %}

{% tab title="Emacs" %} Clone the juvix-mode repository

git clone https://github.com/anoma/juvix-mode.git

And add the following lines to your Emacs configuration file:

(push "/path/to/juvix-mode/" load-path)
(require 'juvix-mode)

See the juvix-mode repository for usage information. {% endtab %} {% endtabs %} {% endstep %} {% endstepper %}

{% hint style="info" %} We will continuously add support for more platforms and IDEs . {% endhint %}

Juvix Documentation

The Juvix documentation is available at https://docs.juvix.org.