TezzNative Getting Started

First project walkthrough with copy/paste commands

Build your first TezzNative app in minutes

This guide creates a project, runs it, builds binaries, and validates your environment.

1) Install SDK

Linux/macOS:
curl -fsSL "https://tn.tezzcorp.com/download/install.sh?nocache=$(date +%s)" | bash

Windows CMD:
curl -fsSL -o install.cmd "https://tn.tezzcorp.com/download/install.cmd?nocache=%RANDOM%%RANDOM%" && install.cmd

Windows PowerShell:
iwr "https://tn.tezzcorp.com/download/install.ps1?nocache=$([DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds())" -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1

Default scope (Windows): user install under %USERPROFILE%\TezzNative
Optional machine scope:
set TEZZ_INSTALL_SCOPE=machine
install.cmd install

2) Create your first project

tezz init hello-tezz
cd hello-tezz

# default init (minimal):
#   tezz.mod
#   tezz.lock
#   .tezz/cache/

# full scaffold (optional):
tezz init hello-tezz --template cli

3) Run and build

tezz doctor
tezz update --check
tezz install net

# run from any location
tezz run main.tn

# or scaffold mode
tezz run src/main.tn

# platform builds
tezz build src/main.tn --platform linux
tezz build src/main.tn --platform windows
tezz build src/main.tn --platform macos
tezz build src/main.tn --platform android
tezz build src/main.tn --platform tezzos

4) Create an input-based app

cat > src/calc.tn <<'TN'
import "std"

fn main() -> int:
  a:int = input("A = ") as int
  b:int = input("B = ") as int
  say(a + b)
  ret 0
TN

tezz run src/calc.tn

5) Validate before shipping

# fast sanity
tezz test --smoke

# full validation
tezz test
tezz release

Next Steps

- Read full docs: /docs/
- Language guide: /docs/language
- Searchable examples: /docs/examples
- Browse SDK functions: /docs/sdk
- Browse frameworks: /frameworks/
- Review backend architecture: /docs/backend
- Review TezzDB usage: /docs/tezzdb
- Install artifacts: /download/