Installation

System Requirements

Minimum Requirements

Component	Requirement
OS	Linux, macOS, Windows
Rust	1.95+
Memory	4 GB RAM
Disk	2 GB free space

Recommended

Component	Requirement
Rust	1.95+ (latest supported)
Memory	8 GB RAM
CPU	Multi-core processor

Installing Rust

If you don’t have Rust installed:

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

Set the correct toolchain version:

rustup default 1.95

Add the WASM target for building components:

rustup target add wasm32-wasip2

Installing GTC CLI

Install the gtc router first, then let gtc install install the Greentic companion tools. Do not install greentic-cli or the individual companion crates directly for normal use; gtc install keeps the delegated binaries aligned with the router.

cargo-binstall (Recommended)

cargo install cargo-binstall
cargo binstall gtc
gtc install
gtc doctor

cargo binstall gtc installs the thin gtc router binary. gtc install then installs the Greentic companion tools that gtc delegates to, such as greentic-dev, greentic-setup, greentic-start, greentic-pack, and greentic-flow.

From Source

git clone https://github.com/greenticai/greentic.git
cd greentic/greentic
cargo build --release

# Add to PATH
export PATH="$PATH:$(pwd)/target/release"
gtc install
gtc doctor

Pre-built Binaries

Download from GitHub Releases:

# macOS (Apple Silicon)
curl -LO https://github.com/greenticai/greentic/releases/latest/download/gtc-darwin-arm64.tar.gz
tar -xzf gtc-darwin-arm64.tar.gz
sudo mv gtc /usr/local/bin/

# macOS (Intel)
curl -LO https://github.com/greenticai/greentic/releases/latest/download/gtc-darwin-x64.tar.gz

# Linux (x86_64)
curl -LO https://github.com/greenticai/greentic/releases/latest/download/gtc-linux-x64.tar.gz

# Windows
# Download gtc-windows-x64.zip from releases

Verify Installation

gtc --version
gtc doctor

Optional Dependencies

Redis (Session Storage)

For production session persistence:

Docker

docker run -d --name redis -p 6379:6379 redis:alpine

Homebrew (macOS)

brew install redis
redis-server

Ngrok/Cloudflared (Public URLs)

For webhook-based providers (Telegram, Slack, etc.):

Ngrok

# Install
brew install ngrok/ngrok/ngrok  # macOS
# or download from https://ngrok.com/download

# Configure
ngrok config add-authtoken YOUR_TOKEN

# Run
ngrok http 8080

Cloudflared

# Install
brew install cloudflared  # macOS
# or download from https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/

# Run
cloudflared tunnel --url http://localhost:8080

Development Tools

Greentic Toolchain

Install or update the delegated Greentic binaries used by the gtc router:

gtc install

Use gtc install --dry-run to preview the install plan. For controlled environments, pin the toolchain:

gtc install --release 1.0.15
gtc install --manifest ./greentic-toolchain.json

Component Authoring

gtc install installs the standard companion tools. For standalone component development you may also install cargo-component:

cargo binstall cargo-component

Then use the delegated component surface:

gtc dev component --help

Verifying Your Setup

Run the following to verify everything is working:

# Check GTC CLI
gtc --help

# Check Rust WASM target
rustup target list --installed | grep wasm32-wasip2

# Create and run a test bundle
gtc wizard --dry-run

Troubleshooting

Common Issues

Error: “wasm32-wasip2 target not found”

rustup target add wasm32-wasip2

Error: “Permission denied”

# On Linux/macOS, ensure binary is executable
chmod +x /usr/local/bin/gtc

Next Steps

• Quick Start - Create your first digital worker
• Architecture Overview - Understand the platform