# XamiLib Ruby — Instalación

**XamiLib para Ruby** (`xamisdk_client`) es la librería que permite a tu aplicación
Ruby firmar a través del servicio local del xamiSDK. Tu aplicación habla con el
servicio local (nunca con Xami directamente); el documento no sale de tu red. Sin
dependencias externas: usa `net/http` y `json` de la stdlib.

## Requisitos

- Ruby 2.7 o superior.
- El servidor xamiSDK instalado, pareado y corriendo (`xamisdk serve`).
- Una credencial de aplicación (`xamisdk wrapper:create --name mi-app`), que te da un
  `wrapper_key` y un `wrapper_secret`.

## Instalación

Descarga el paquete desde https://sdk.xami.run/files/xamisdk-ruby-0.1.0.zip,
descomprímelo, construye la gema e instálala:

```bash
curl -O https://sdk.xami.run/files/xamisdk-ruby-0.1.0.zip
unzip xamisdk-ruby-0.1.0.zip
cd xamisdk-ruby
gem build xamisdk_client.gemspec
gem install ./xamisdk_client-0.1.0.gem
```

También puedes usarla sin instalar, apuntando a la carpeta descomprimida con
`require_relative 'xamisdk-ruby/lib/xamisdk_client'`.

## Primer uso

```ruby
require 'xamisdk_client'

xami = XamiSDKClient::XamiSDK.new(
  endpoint: 'http://127.0.0.1:8300',
  wrapper_key: 'wrp_...',
  wrapper_secret: 'wsec_...'
)

puts xami.health.self['paired'] ? 'pareado' : 'sin parear'
```