Tenzro Testnet is live. Get testnet TNZO

Getting Started

This guide will walk you through installing Tenzro, starting your first node, creating a wallet, and making your first transactions.

Prerequisites

No prerequisites required. Tenzro CLI and node binaries are self-contained and ready to run on macOS and Linux systems.

Installation

Quick Install (Recommended)

Install the Tenzro CLI and node binaries with a single command:

# macOS / Linux
curl -sSL https://get.tenzro.network | sh

# Verify installation
tenzro-cli --version
tenzro-node --version

Manual Download

Download pre-built binaries for your platform:

# Download latest release
wget https://releases.tenzro.network/tenzro-cli-latest
wget https://releases.tenzro.network/tenzro-node-latest

# Make executable and move to PATH
chmod +x tenzro-cli-latest tenzro-node-latest
sudo mv tenzro-cli-latest /usr/local/bin/tenzro-cli
sudo mv tenzro-node-latest /usr/local/bin/tenzro-node

Advanced: Build from Source

For developers who want to build from source or contribute to the project:

# Prerequisites: Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone https://github.com/tenzro/tenzro-network.git
cd tenzro-network
cargo build --release

# Binaries will be in target/release/
./target/release/tenzro-cli --version

Starting a Node

Tenzro supports multiple node roles: Validator, ModelProvider, TeeProvider, and LightClient. For getting started, we'll run a light client node.

Start a Light Client

tenzro-node \
  --role light-client \
  --listen-addr /ip4/0.0.0.0/tcp/9000 \
  --rpc-addr 127.0.0.1:8545 \
  --boot-nodes /ip4/your-bootstrap-ip/tcp/9000/p2p/12D3K...

Start a Validator

# Validators require staked TNZO
tenzro-node \
  --role validator \
  --listen-addr /ip4/0.0.0.0/tcp/9000 \
  --rpc-addr 127.0.0.1:8545 \
  --data-dir ~/.tenzro/validator

Verify Node is Running

# Check node status via CLI
tenzro-cli info

# Or via RPC
curl -X POST http://127.0.0.1:8545 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tenzro_nodeInfo","params":[],"id":1}'

Onboarding: Identity and Wallet Setup

Before using the network, you need a TDIP identity and a wallet. Tenzro provides two onboarding paths: creating a new identity or importing an existing private key.

Option 1: One-Click Join (Create New)

The simplest way to get started. This auto-provisions a cryptographic keypair, creates a multi-signature wallet, registers your TDIP identity on the ledger, and detects your hardware profile -- all in a single command.

# Via CLI
tenzro-cli join --name "Alice" --rpc http://127.0.0.1:8545

# Output:
# Connected to network (Chain ID: 1337)
# Identity and wallet provisioned on Tenzro Ledger
#
# DID:     did:tenzro:human:550e8400-e29b-41d4-...
# Address: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb5
# Wallet:  Multi-signature threshold wallet

# Or via RPC
curl -X POST http://127.0.0.1:8545 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tenzro_participate","params":[{"display_name":"Alice"}],"id":1}'

Option 2: Import from Private Key

If you have an existing private key, you can import it to create your identity and wallet. The key is used to derive your wallet address, and wallet shares are generated and stored in a securely encrypted keystore.

# Via CLI
tenzro-cli wallet import 0x4c0883a69102937d... \
  --name "Alice"

# You'll be prompted for a wallet password
# Output:
# DID:     did:tenzro:human:661f9500-...
# Address: 0x8Ba1f109551bD432803012645Ac136ddd64DBA72

Desktop App Setup

The Tenzro desktop app provides a guided Setup page on first launch. It offers two tabs: "Create New" and "Import Existing". On success, you are redirected to the Dashboard with your identity, wallet, and hardware profile displayed.

# Download and install the desktop app
# Available for macOS, Windows, and Linux

# The Setup page will appear on first launch
# Enter your display name, password, and RPC endpoint
# Click "Create Identity & Wallet" or import an existing key

Wallet Operations

List Wallets

tenzro-cli wallet list

Check Balance

# Check TNZO balance
tenzro-cli wallet balance --address 0x742d35Cc...

Send TNZO

# Send 10 TNZO to another address
tenzro-cli wallet send 0xRecipientAddr 10 --asset TNZO

Getting Testnet TNZO

Request testnet TNZO from the built-in faucet:

# Via the Web Verification API faucet endpoint
curl -X POST http://127.0.0.1:8080/api/faucet \
  -H "Content-Type: application/json" \
  -d '{"address":"0x742d35Cc..."}'

Requesting AI Inference

List available models and request inference:

# List available models
tenzro-cli model list

# Request inference
tenzro-cli inference \
  --model llama-3-70b \
  --prompt "What is the capital of France?" \
  --max-tokens 100

Next Steps

← Documentation HomeNext: Architecture →