# tt-lang internal S3 PyPI index

This is Tenstorrent's internal PyPI index for pre-release `tt-lang` wheels. Public
releases are on [PyPI](https://pypi.org/project/tt-lang/); this index hosts the
more frequently updated development builds.

## Install

Pick a published version from the workflow summary or the package list below, then
select it explicitly (public PyPI also hosts `tt-lang`):

Nightly development wheels are grouped by year-month:

```bash
pip install \
  --extra-index-url https://pypi.eng.aws.tenstorrent.com/<YYYY-MM>/ \
  --extra-index-url https://download.pytorch.org/whl/cpu \
  "tt-lang==<version>"
```

Light wheels built and device-tested against a specific tt-metal commit are
published as direct wheel directories under `tt-lang/<ttmetal7>/`, where
`<ttmetal7>` is that commit's 7-character prefix. The directory contains both the
`tt-lang` `+light` wheel and the `tt-lang-light` metapackage, plus this README as
`README.txt`. The `tt-lang-light` wheel is a pure metapackage; the supported
CPython ABIs and glibc floor are carried by the
`tt_lang-<version>+light-cp310-cp310-manylinux_2_34_x86_64.whl` and
`tt_lang-<version>+light-cp312-cp312-manylinux_2_34_x86_64.whl` files in the
same directory. The `ttl.build_info()["tt_metal"]` value in each `tt-lang`
wheel must equal `<ttmetal7>` expanded to the requested tt-metal commit. Use
these when the environment already provides `ttnn` from an external tt-metal at
that commit:

```bash
pip install \
  --find-links https://pypi.eng.aws.tenstorrent.com/tt-lang/<ttmetal7>/ \
  --extra-index-url https://download.pytorch.org/whl/cpu \
  "tt-lang-light==<version>"
```

## Verify and run

Confirm the version and the source revisions the wheel was built from. Include
`build_info()` when filing issues -- it reports the tt-lang commit and the
tt-metal tag and commit the wheel was built against, which pins down the exact
tt-metal a per-commit light wheel targets:

```bash
python -c 'import ttnn, ttl; print(ttnn.__file__, ttl.__version__)'
python -c 'import ttl; print(ttl.build_info())'
```

`tt-lang-setup` copies the tutorials into the environment; run one to check the
install end to end:

```bash
tt-lang-setup
python tutorials/elementwise/step_4_multinode_grid_full.py
```

For the full walkthrough, including configuring an external tt-metal for light
wheels, see the [tt-lang documentation](https://docs.tenstorrent.com/tt-lang) and
the getting-started guide linked below.

## More

- [Getting started](https://github.com/tenstorrent/tt-lang/blob/main/docs/sphinx/getting-started.md)
  (internal S3 wheels section)
- [Documentation](https://docs.tenstorrent.com/tt-lang/)