💨 Instalación Automática en Termux — Recomendada

Bot de WhatsApp Multi Device con SQLite local y soporte multi-instancia.

Warning

AVISO IMPORTANTE > Este bot no está afiliado con WhatsApp Inc.. El uso indebido (spam, etc.) podría resultar en la suspensión de tu cuenta de WhatsApp.
Úsalo bajo tu propio riesgo y responsabilidad. ¡Sé un usuario amable! 💖

Ruby Hoshino Bot es una versión personalizada y editada de Yuki Wa Bot, mantenida por Dioneibi-rip.

¡Prueba el Bot en Acción!

¿Quieres ver la magia de Ruby antes de instalar? ¡Únete a la comunidad y pruébalo! 💖

Únete al Grupo Oficial

✨ Características principales

Pilar	Qué aporta
🗄️ SQLite puro	No necesitas MongoDB, Redis obligatorio, cuentas externas ni paneles de base de datos. Los datos viven en `src/database/`.
🤖 Multi-instancia / JadiBots	Permite ejecutar sub-bots desde la misma base del proyecto mediante sesiones en `RubyJadiBots`.
👑 Bot Primario	Soporte para definir un bot principal por chat y evitar respuestas duplicadas cuando hay varias sesiones activas.
🧩 Funciones de comunidad	Administración de grupos, bienvenidas, stickers, descargas, juegos, economía, búsquedas y herramientas de entretenimiento.
🔐 Sesiones locales	Las sesiones de Baileys se guardan localmente para un reinicio más estable.

📋 Requisitos rápidos

Antes de instalar, confirma que tienes:

Node.js 18 o superior recomendado.
Git para clonar el repositorio.
Python + compilador C++ + make/build tools para compilar dependencias nativas como better-sqlite3 si no existe binario precompilado para tu plataforma.
Conexión estable a internet durante npm install.

Punto crítico: Ruby Hoshino usa better-sqlite3@^11.10.0. Esta dependencia puede usar node-gyp, por lo que tu sistema debe tener herramientas de compilación nativa instaladas.

🚀 Instalación universal paso a paso

🚩 ESCRIBE LOS SIGUIENTES COMANDOS UNO POR UNO:

Instalación en termux

Recomendación: instala Termux desde F-Droid. Algunas ROMs o arquitecturas pueden requerir más tiempo para compilar dependencias nativas.

🪼 VER EL APARTADO Y INSTALACION EN TERMUX

💨 Instalación Automática en Termux — Recomendada

Esta es la forma más segura para Android/ARM64. El script termux-install.sh prepara Termux antes de tocar npm: instala python, make, clang, pkg-config, cmake, ninja, SQLite, libvips, libwebp, FFmpeg y librerías Cairo/Pango opcionales para dependencias tipo canvas; además configura node-gyp, fuerza compilación compatible con Android y preinyecta node-addon-api para evitar errores de dependencias desde GitHub.

Copia y pega este bloque completo:

termux-setup-storage && \
pkg update -y && \
pkg upgrade -y && \
pkg install git -y && \
rm -rf Ruby-Hoshino-Bot && \
git clone https://github.com/Dioneibi-rip/Ruby-Hoshino-Bot.git && \
cd Ruby-Hoshino-Bot && \
chmod +x termux-install.sh && \
bash termux-install.sh

Cuando termine, inicia Ruby:

npm start

🍃 Instalación Manual en Termux

Otorgar permisos de almacenamiento

termux-setup-storage

Actualizar el sistema e instalar todas las dependencias

pkg update -y && pkg upgrade -y && \
pkg install -y nodejs-lts git python make clang binutils pkg-config cmake ninja patchelf \
libsqlite libwebp ffmpeg imagemagick

Clonar el repositorio y entrar al directorio

git clone https://github.com/Dioneibi-rip/Ruby-Hoshino-Bot.git && \
cd Ruby-Hoshino-Bot

Configurar variables de entorno

export CC="$PREFIX/bin/clang" && \
export CXX="$PREFIX/bin/clang++" && \
export PKG_CONFIG_PATH="$PREFIX/lib/pkgconfig:$PREFIX/share/pkgconfig:$PKG_CONFIG_PATH" && \
export GYP_DEFINES="android_ndk_path= host_os=linux OS=android" && \
export NODE_PATH="$PREFIX/lib/node_modules:$NODE_PATH"

Limpiar caché e instalar dependencias (Compilación de SQLite nativa)

npm cache clean --force && \
npm install -g node-gyp --no-audit --no-fund && \
npm install --no-audit --no-fund --foreground-scripts

Iniciar el bot

npm start

Mantener Ruby 24/7 con PM2 en Termux

termux-wake-lock

npm install -g pm2

pm2 start index.js --name ruby-hoshino

pm2 save

pm2 logs ruby-hoshino

Linux / VPS Ubuntu-Debian

🐧 VER EL APARTADO Y INSTALACIÓN

En Ubuntu/Debian limpio no uses sudo apt install nodejs directamente: los repositorios del sistema pueden traer una versión antigua. Primero añade NodeSource para instalar Node.js LTS 20.x o superior.

Actualiza el sistema e instala herramientas base para añadir repositorios HTTPS.

sudo apt-get update && \
sudo apt-get install -y ca-certificates curl gnupg

Añade el repositorio oficial de NodeSource para Node.js 20.x LTS.

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

Instala Node.js y dependencias nativas obligatorias para clonar, compilar módulos y procesar multimedia.

sudo apt-get install -y nodejs git python3 build-essential ffmpeg libwebp-dev

Verifica que Node.js 20.x o superior y npm quedaron disponibles.

node --version && npm --version

Clona el repositorio y entra al proyecto.

git clone https://github.com/Dioneibi-rip/Ruby-Hoshino-Bot.git && \
cd Ruby-Hoshino-Bot

Instala dependencias de Node.js e inicia Ruby.

npm install && \
npm start

Ejecución recomendada en VPS con PM2

sudo npm install -g pm2

pm2 start index.js --name ruby-hoshino

pm2 save

pm2 logs ruby-hoshino

Windows

🏴 VER EL APARTADO Y INSTALACIÓN EN WINDOWS

Recomendado: abre PowerShell como Administrador y usa winget para instalar versiones actuales y agregarlas al PATH automáticamente.

Instala Node.js LTS, Git, FFmpeg, Python y Visual Studio Build Tools.

winget install --id OpenJS.NodeJS.LTS -e --source winget
winget install --id Git.Git -e --source winget
winget install --id Gyan.FFmpeg -e --source winget
winget install --id Python.Python.3.12 -e --source winget
winget install --id Microsoft.VisualStudio.2022.BuildTools -e --source winget --override "--wait --passive --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"

Cierra y vuelve a abrir PowerShell para recargar las variables de entorno. Verifica que todo quedó en el PATH.

node --version
npm --version
git --version
ffmpeg -version
python --version

Clona el repositorio y entra al proyecto.

git clone https://github.com/Dioneibi-rip/Ruby-Hoshino-Bot.git
cd Ruby-Hoshino-Bot

Instala dependencias e inicia Ruby.

npm install
npm start

Instalación manual si no tienes winget

Instala Node.js LTS desde https://nodejs.org/ y deja marcada la opción para agregar Node.js al PATH.
Instala Git for Windows desde https://git-scm.com/download/win y selecciona la opción para usar Git desde PowerShell o el símbolo del sistema.
Instala FFmpeg desde https://www.gyan.dev/ffmpeg/builds/ y agrega la carpeta bin de FFmpeg al PATH.
Instala Python 3 desde https://www.python.org/downloads/ y marca Add python.exe to PATH.
Instala Visual Studio Build Tools desde https://visualstudio.microsoft.com/visual-cpp-build-tools/ con la carga de trabajo Desktop development with C++.
Reinicia PowerShell y ejecuta los comandos de verificación, clonación, npm install y npm start mostrados arriba.

🔐 Primer inicio y vinculación con WhatsApp

Ejecuta npm start.
Sigue las instrucciones de la terminal para vincular WhatsApp mediante QR o código, según el modo disponible.
Mantén la terminal abierta mientras el bot está funcionando.
Si usas PM2, revisa los logs con pm2 logs ruby-hoshino.

Obtener un nuevo código o limpiar sesión principal

cd Ruby-Hoshino-Bot

rm -rf RubySessions

npm start

En Windows PowerShell, usa:

Remove-Item -Recurse -Force RubySessions

npm start

💾 Base de datos SQLite local

Ruby Hoshino Bot usa SQLite como motor principal de persistencia local mediante better-sqlite3. Al iniciar, el bot crea y usa archivos locales dentro de src/database/, incluyendo datos del bot y store de Baileys.

Ventajas:

Instalación más simple: no requiere MongoDB ni credenciales externas.
Datos persistentes en archivos locales.
Mejor rendimiento para operaciones frecuentes del bot.
Configuración lista para producción con pragmas como WAL, synchronous=NORMAL, busy_timeout, caché en memoria y tablas temporales en RAM.

Configuración opcional con `.env`

cp .env.example .env

Luego edita .env solo si necesitas ajustar límites o rutas avanzadas. Para la mayoría de usuarios basta con iniciar:

npm start

🧬 Multi-instancia: JadiBots y Bot Primario

Ruby Hoshino puede trabajar con múltiples sesiones:

Bot principal: sesión estándar guardada en RubySessions.
JadiBots: sub-bots o sesiones secundarias guardadas en RubyJadiBots.
Bot Primario por chat: ayuda a decidir qué instancia responde en un grupo para reducir duplicados cuando hay más de un bot conectado.

Consejos operativos:

No compartas carpetas de sesión públicamente.
Haz respaldos antes de borrar RubySessions, RubyJadiBots o src/database/.
Si varias instancias responden a la vez, revisa la configuración del bot primario del chat.

🧯 Solución de problemas

Error: `better-sqlite3` / `node-gyp build failed`

Este error significa que Node intentó compilar better-sqlite3 en tu equipo y no encontró las herramientas necesarias. La solución es instalar Python, make y un compilador C++.

Termux

pkg update -y && pkg upgrade -y

pkg install nodejs git python make clang binutils -y

npm install

Ubuntu/Debian

sudo apt-get update && \
sudo apt-get install -y ca-certificates curl gnupg && \
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && \
sudo apt-get install -y nodejs git python3 build-essential ffmpeg libwebp-dev

npm install

Windows

winget install --id Python.Python.3.12 -e --source winget
winget install --id Microsoft.VisualStudio.2022.BuildTools -e --source winget --override "--wait --passive --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"

Si no puedes usar winget, instala manualmente:

Python 3 desde https://www.python.org/downloads/ y marca Add python.exe to PATH.
Visual Studio Build Tools desde https://visualstudio.microsoft.com/visual-cpp-build-tools/ con Desktop development with C++.

Luego reinicia PowerShell y vuelve a ejecutar:

npm install

Error: `python not found` o `gyp ERR! find Python`

Instala Python según tu sistema y verifica:

python --version

python3 --version

Error: permisos al instalar dependencias globales

En Linux/VPS, usa sudo solo para paquetes globales si tu instalación lo requiere:

sudo npm install -g pm2

En Termux normalmente no uses sudo.

El bot no inicia después de borrar sesiones

Vuelve a generar sesión:

npm start

Si el problema continúa, elimina solo la carpeta de sesión afectada y conserva src/database/ si quieres mantener economía, niveles y datos del bot.

🍉︎ `HOSTINGS RECOMENDADOS`

Si deseas que Ruby esté activa 24/7 sin depender de tu celular, te recomendamos estos servicios:

`AKIRAX HOST`

Dashboard: dash.akirax.net
Panel: panel.akirax.net
Canal Oficial: Únete Aquí
Grupo de Soporte: Únete Aquí

`౨ৎ SWALLOX HOST ౨ৎ`

Dashboard: dash.swallox.com
Panel: panel.swallox.com
Canal Oficial: Únete Aquí
Grupo de Soporte: Únete Aquí

☁️ `DESPLIEGUE RÁPIDO EN LA NUBE`

Importante: plataformas gratuitas pueden suspender procesos por inactividad. Para uso estable 24/7 se recomienda VPS o hosting especializado.

💬 `COMUNIDAD Y CANALES OFICIALES`

¿Tienes dudas o quieres estar al día con las novedades? ¡Únete a nuestros canales oficiales! 💫

`🍋‍🟩 𝘿𝙀𝙎𝘼𝙍𝙍𝙊𝙇𝙇𝘼𝘿𝙊𝙍𝙀𝙎`

`🪷 𝘾𝙍𝙀𝘼𝘿𝙊𝙍 𝙊𝙁𝙄𝘾𝙄𝘼𝙇`

¡GRACIAS POR PREFERIRNOS! 🫧

Name		Name	Last commit message	Last commit date
Latest commit History 2,671 Commits
scripts		scripts
src		src
tmp		tmp
.env.example		.env.example
.gitignore		.gitignore
LICENSE.txt		LICENSE.txt
README.md		README.md
index.js		index.js
logo.ico		logo.ico
package.json		package.json
settings.js		settings.js
termux-install.sh		termux-install.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

¡Prueba el Bot en Acción!

✨ Características principales

📋 Requisitos rápidos

🚀 Instalación universal paso a paso

Instalación en termux

💨 Instalación Automática en Termux — Recomendada

🍃 Instalación Manual en Termux

Mantener Ruby 24/7 con PM2 en Termux

Linux / VPS Ubuntu-Debian

Ejecución recomendada en VPS con PM2

Windows

Instalación manual si no tienes winget

🔐 Primer inicio y vinculación con WhatsApp

Obtener un nuevo código o limpiar sesión principal

💾 Base de datos SQLite local

Configuración opcional con `.env`

🧬 Multi-instancia: JadiBots y Bot Primario

🧯 Solución de problemas

Error: `better-sqlite3` / `node-gyp build failed`

Termux

Ubuntu/Debian

Windows

Error: `python not found` o `gyp ERR! find Python`

Error: permisos al instalar dependencias globales

El bot no inicia después de borrar sesiones

🍉︎ `HOSTINGS RECOMENDADOS`

`AKIRAX HOST`

`౨ৎ SWALLOX HOST ౨ৎ`

☁️ `DESPLIEGUE RÁPIDO EN LA NUBE`

💬 `COMUNIDAD Y CANALES OFICIALES`

`🍋‍🟩 𝘿𝙀𝙎𝘼𝙍𝙍𝙊𝙇𝙇𝘼𝘿𝙊𝙍𝙀𝙎`

`🪷 𝘾𝙍𝙀𝘼𝘿𝙊𝙍 𝙊𝙁𝙄𝘾𝙄𝘼𝙇`

About

Used by

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

¡Prueba el Bot en Acción!

✨ Características principales

📋 Requisitos rápidos

🚀 Instalación universal paso a paso

Instalación en termux

💨 Instalación Automática en Termux — Recomendada

🍃 Instalación Manual en Termux

Mantener Ruby 24/7 con PM2 en Termux

Linux / VPS Ubuntu-Debian

Ejecución recomendada en VPS con PM2

Windows

Instalación manual si no tienes winget

🔐 Primer inicio y vinculación con WhatsApp

Obtener un nuevo código o limpiar sesión principal

💾 Base de datos SQLite local

Configuración opcional con .env

🧬 Multi-instancia: JadiBots y Bot Primario

🧯 Solución de problemas

Error: better-sqlite3 / node-gyp build failed

Termux

Ubuntu/Debian

Windows

Error: python not found o gyp ERR! find Python

Error: permisos al instalar dependencias globales

El bot no inicia después de borrar sesiones

🍉︎ HOSTINGS RECOMENDADOS

AKIRAX HOST

౨ৎ SWALLOX HOST ౨ৎ

☁️ DESPLIEGUE RÁPIDO EN LA NUBE

💬 COMUNIDAD Y CANALES OFICIALES

🍋‍🟩 𝘿𝙀𝙎𝘼𝙍𝙍𝙊𝙇𝙇𝘼𝘿𝙊𝙍𝙀𝙎

🪷 𝘾𝙍𝙀𝘼𝘿𝙊𝙍 𝙊𝙁𝙄𝘾𝙄𝘼𝙇

About

Resources

Stars

Watchers

Forks

Used by

Contributors

Languages

Configuración opcional con `.env`

Error: `better-sqlite3` / `node-gyp build failed`

Error: `python not found` o `gyp ERR! find Python`

🍉︎ `HOSTINGS RECOMENDADOS`

`AKIRAX HOST`

`౨ৎ SWALLOX HOST ౨ৎ`

☁️ `DESPLIEGUE RÁPIDO EN LA NUBE`

💬 `COMUNIDAD Y CANALES OFICIALES`

`🍋‍🟩 𝘿𝙀𝙎𝘼𝙍𝙍𝙊𝙇𝙇𝘼𝘿𝙊𝙍𝙀𝙎`

`🪷 𝘾𝙍𝙀𝘼𝘿𝙊𝙍 𝙊𝙁𝙄𝘾𝙄𝘼𝙇`