Instalación

Requisitos del sistema

Requisitos mínimos

Componente	Requisito
Sistema operativo	Linux, macOS, Windows
Rust	1.90+
Memoria	4 GB RAM
Disco	2 GB de espacio libre

Recomendado

Componente	Requisito
Rust	1.91 (latest)
Memoria	8 GB RAM
CPU	Procesador multinúcleo

Instalar Rust

Si no tienes Rust instalado:

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

Establece la versión correcta del toolchain:

rustup default 1.90

Agrega el target WASM para construir componentes:

rustup target add wasm32-wasip2

Instalar GTC CLI

Cargo (Recomendado)

cargo install greentic-cli

Desde el código fuente

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

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

Binarios precompilados

Descarga desde 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

Verificar la instalación

gtc --version

Salida esperada:

gtc 0.4.x

Dependencias opcionales

NATS (Bus de mensajes)

Para despliegues de producción:

Docker

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

Homebrew (macOS)

brew install nats-server
nats-server

Descarga directa

Descarga desde nats.io

Redis (Almacenamiento de sesiones)

Para persistencia de sesiones en producción:

Docker

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

Homebrew (macOS)

brew install redis
redis-server

Ngrok/Cloudflared (URLs públicas)

Para providers basados en webhooks (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

Herramientas de desarrollo

Constructor de packs

Construye archivos .gtpack:

cargo install greentic-pack

Validador de flows

Valida definiciones de flow:

cargo install greentic-flow

Creación de componentes

Crea componentes WASM:

cargo install greentic-component

Verificar tu entorno

Ejecuta lo siguiente para verificar que todo funciona:

# 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

Resolución de problemas

Problemas comunes

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

Siguientes pasos

• Inicio rápido - Crea tu primer trabajador digital
• Resumen de la arquitectura - Comprende la plataforma