Skip to content

Commit

Permalink
#8764: To revert later after review - stash away new installation met…
Browse files Browse the repository at this point in the history
…hod for wheel
  • Loading branch information
tt-rkim committed Aug 21, 2024
1 parent e39b99d commit 6571f9c
Showing 1 changed file with 20 additions and 15 deletions.
35 changes: 20 additions & 15 deletions INSTALLING.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,6 @@

These instructions will guide you through the installation of Tenstorrent system tools and drivers, followed by the installation of TT-Metalium and TT-NN.

> [!IMPORTANT]
>
> If you are using a release version of this software, please check the installation instructions packaged with that version. You can find them in either the release assets for that version, or in the source files for that version tag.
---

## Installation Steps
Expand Down Expand Up @@ -80,7 +76,7 @@ sudo -E python3 setup_hugepages.py enable && sudo -E python3 setup_hugepages.py
> If you do not want to use the models or follow the tutorials and want to
> immediately start using the API, you may install just the wheel.
1. Install git and git-lfs.
1. Install git and git-lfs

```sh
sudo apt install git git-lfs
Expand All @@ -94,19 +90,29 @@ cd tt-metal
git submodule foreach 'git lfs fetch --all && git lfs pull'
```

3. Install either from source, or from our release wheel.
3. Set up the environment variables. For Grayskull, use:

### Option 1: From source

We use CMake for our build flows.
```sh
export ARCH_NAME=grayskull
export TT_METAL_HOME=$(pwd)
export PYTHONPATH=$(pwd)
```

Set up the environment variables and invoke our build scripts. Note that for
source builds, you must set these environment variables every time.
For Wormhole boards, use:

```sh
export ARCH_NAME=<ARCH_NAME>
export ARCH_NAME=wormhole_b0
export TT_METAL_HOME=$(pwd)
export PYTHONPATH=$(pwd)
```

4. Install either from source, or from our release wheel.

### Option 1: From source

We use CMake for our build flows.

```sh
./build_metal.sh

# If you would like an out-of-the-box virtual environment to use,
Expand Down Expand Up @@ -139,14 +145,13 @@ pip install <wheel_file.whl>
```

If you are going to try our pre-built models in `models/`, then you must also
further install their required dependencies and environment variables:
further install their requirements:

```sh
export PYTHONPATH=$(pwd)
pip install -r tt_metal/python_env/requirements-dev.txt
```

4. Start coding
5. Start coding

You are all set! Visit the [TT-NN Basic examples page](https://docs.tenstorrent.com/ttnn/latest/ttnn/usage.html#basic-examples) or get started with [simple kernels on TT-Metalium](https://docs.tenstorrent.com/tt-metalium/latest/tt_metal/examples/index.html).

Expand Down

0 comments on commit 6571f9c

Please sign in to comment.