Installation

Systemanforderungen

Mindestanforderungen

Komponente	Anforderung
OS	Linux, macOS, Windows
Rust	1.90+
Memory	4 GB RAM
Disk	2 GB freier Speicherplatz

Empfohlen

Komponente	Anforderung
Rust	1.91 (latest)
Memory	8 GB RAM
CPU	Mehrkernprozessor

Rust installieren

Falls Rust noch nicht installiert ist:

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

Setzen Sie die richtige Toolchain-Version:

rustup default 1.90

Fügen Sie das WASM-Ziel zum Bauen von Komponenten hinzu:

rustup target add wasm32-wasip2

GTC CLI installieren

Cargo (Empfohlen)

cargo install greentic-cli

Aus dem Quellcode

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

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

Vorgebaute Binärdateien

Von GitHub Releases herunterladen:

# 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

Installation überprüfen

gtc --version

Erwartete Ausgabe:

gtc 0.4.x

Optionale Abhängigkeiten

NATS (Message Bus)

Für Produktions-Deployments:

Docker

docker run -d --name nats -p 4222:4222 nats:latest

Homebrew (macOS)

brew install nats-server
nats-server

Direkter Download

Herunterladen von nats.io

Redis (Session Storage)

Für persistente Produktions-Sessions:

Docker

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

Homebrew (macOS)

brew install redis
redis-server

Ngrok/Cloudflared (Öffentliche URLs)

Für webhook-basierte Provider (Telegram, Slack usw.):

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

Entwicklungswerkzeuge

Pack Builder

.gtpack-Archive bauen:

cargo install greentic-pack

Flow Validator

Flow-Definitionen validieren:

cargo install greentic-flow

Komponenten-Erstellung

WASM-Komponenten erstellen:

cargo install greentic-component

Ihr Setup verifizieren

Führen Sie Folgendes aus, um zu prüfen, dass alles funktioniert:

# 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

Fehlerbehebung

Häufige Probleme

Error: “wasm32-wasip2 target not found”

rustup target add wasm32-wasip2

Error: “Cannot connect to NATS”

# Start embedded NATS with gtc start
gtc start ./my-bundle --nats on

Error: “Permission denied”

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

Nächste Schritte

• Schnellstart - Ihren ersten digitalen Worker erstellen
• Architekturüberblick - Die Plattform verstehen