# Mac (Intel and Silicon)

### Overview

This guide outlines the steps to install the L1X Cargo plugin for Mac within the L1X SDK environment. The process includes setting up your environment, installing necessary tools, and configuring Cargo for L1X.

### Pre-requisites

#### Install Homebrew

First, install Homebrew, which is necessary for managing packages on macOS.

```bash
/bin/bash -c "$(curl -fsSL <https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>)"

```

#### Install LLVM 15 (WASM to LLVM-IR Dependency by Inkwell)

LLVM version 15 is required, and it can be installed via Homebrew. Note that this is a keg-only version.

```bash
brew install llvm@15

```

#### Configure Environment Variables for LLVM 17

Since LLVM 15 is keg-only and not symlinked into `/opt/homebrew`, you'll need to adjust your environment variables to use LLVM 15 explicitly.

#### Set PATH for LLVM

This ensures that the system uses LLVM 17's binaries.

```bash
echo 'export PATH="/opt/homebrew/opt/llvm@15/bin:$PATH"' >> ~/.zshrc

```

#### Configure Compiler and Linker Flags

To use the bundled libc++, set the following LDFLAGS and include directory settings:

```bash
export LDFLAGS="-L/opt/homebrew/opt/llvm@15/lib/c++ -Wl,-rpath,/opt/homebrew/opt/llvm@15/lib/c++"
export LDFLAGS="-L/opt/homebrew/opt/llvm@15/lib"
export CPPFLAGS="-I/opt/homebrew/opt/llvm@15/include"

```

#### Install LLVM 17 (To Build Object File)

LLVM version 17 is required, and it can be installed via Homebrew. Note that this is a keg-only version.

```bash
brew install llvm@17

```

#### Configure Environment Variables for LLVM 17

Since LLVM 17 is keg-only and not symlinked into `/opt/homebrew`, you'll need to adjust your environment variables to use LLVM 17 explicitly.

#### Set PATH for LLVM

This ensures that the system uses LLVM 17's binaries.

```bash
echo 'export PATH="/opt/homebrew/opt/llvm@17/bin:$PATH"' >> ~/.zshrc

```

#### Configure Compiler and Linker Flags

To use the bundled libc++, set the following LDFLAGS and include directory settings:

```bash
export LDFLAGS="-L/opt/homebrew/opt/llvm@17/lib/c++ -Wl,-rpath,/opt/homebrew/opt/llvm@17/lib/c++"
export LDFLAGS="-L/opt/homebrew/opt/llvm@17/lib"
export CPPFLAGS="-I/opt/homebrew/opt/llvm@17/include"

```

#### Make LLVM17 as Default

```bash
brew link --overwrite llvm@17  # Makes LLVM 17 the default

```

Install Cargo L1X Plugin

The L1X plugin for Cargo is essential for managing L1X-specific tasks in your Rust projects.

```bash
cargo install cargo-l1x --force

```

### Create Project from a Template

Use a template to quickly start a new project with pre-configured settings.

```bash
cargo l1x create some_project --template ft

```

### Build Project

Navigate to your project directory and build the project to ensure everything is set up correctly.

```bash
cd some_project
cargo l1x build

```

In case you have any issues with the above pre-requisites, please install the below dependencies.&#x20;

```bash
brew install pkg-config
brew install openssl
brew install zlib

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://l1x-sdk.gitbook.io/l1x-developer-interface/interface-essentials/l1x-vm-sdk/l1x-native-sdk-for-l1x-vm/set-up-environment/installation/install-cargo-l1x/mac-intel-and-silicon.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.