💨 Instalación Automática en Termux — Recomendada

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/`.
👑 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

Ruby Hoshino puede trabajar con múltiples sesiones:

Bot principal: sesión estándar guardada en RubySessions.
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.
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
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
pnpm-lock.yaml		pnpm-lock.yaml
settings.js		settings.js
termux-install.sh		termux-install.sh

Navigation Menu

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`

🧯 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

Latest commit

History

Folders and files

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

🧯 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`

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

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