Abraham Gómez

Esta guía convierte el quick start oficial en una secuencia de comandos para una Mac con Apple Silicon y 16 GB de RAM. El repositorio es la fuente de verdad; el rendimiento específico del hardware debe verificarse en la máquina objetivo.

1. Revisa la máquina

Instala Docker Desktop para Apple Silicon y asegúrate de que esté ejecutándose. Después clona el repositorio:

git clone https://github.com/Zyrabit-tech/zyrabit-SLM.git
cd zyrabit-SLM

Ejecuta el diagnóstico antes de levantar contenedores:

./zyra-up.sh doctor

En una máquina con 16 GB, cierra aplicaciones que consuman mucha memoria antes de descargar modelos. El comando doctor es la comprobación oficial del repositorio.

2. Configura el entorno

El README indica copiar el archivo de entorno de ejemplo:

cp zyrabit-slm/example.env zyrabit-slm/.env

Ábrelo localmente y configura los valores requeridos por el checkout actual, incluyendo SLM_URL y DB_URL cuando el proyecto los solicite:

open -e zyrabit-slm/.env

No subas este archivo al repositorio. Si el proyecto solicita un token, usa un secreto local en lugar de escribirlo en este artículo:

ZYRABIT_TOKEN=replace-with-a-local-token

El nombre exacto de la variable y el flujo de autenticación deben coincidir con la versión descargada. Esta guía no inventa un endpoint ni un formato de token.

3. Instala el stack

Usa el comando unificado del ciclo de vida:

./zyra-up.sh install

Según el README, esto construye las imágenes, inicia el stack y descarga los modelos requeridos. La primera ejecución puede consumir tiempo, memoria y espacio en disco.

4. Verifica los servicios

Después de la instalación, ejecuta las comprobaciones visuales y de API del repositorio:

./zyra-up.sh verify

Para inspeccionar el stack:

./zyra-up.sh start
./zyra-up.sh stop

5. Comandos útiles

doctor  Diagnostica RAM, hardware y entorno
install Construye imágenes, inicia el stack y descarga modelos
start   Levanta la infraestructura
stop    Detiene la infraestructura
build   Construye imágenes sin iniciar servicios
verify  Ejecuta comprobaciones visuales y probes de API
dev     Ejecuta desarrollo local con uv

6. Si la Mac tiene poca memoria

Empieza con doctor y evita levantar servicios opcionales hasta que el stack base esté saludable. El repositorio documenta n8n como opcional y describe una red de modelos respaldada por Ollama. Usa modelos locales pequeños cuando la configuración actual lo permita y registra el resultado en lugar de asumir un benchmark.

Fuente y capturas

Los comandos y la arquitectura de esta guía se derivan del README oficial de Zyrabit SLM. El código fuente consultado no incluye una secuencia de capturas verificada para Mac M1 Pro, así que esta versión usa comandos de terminal en lugar de inventar capturas.