Repolode
tashfeenahmed

tashfeenahmed/scallopbot

Asistente de IA personal y autohospedado con memoria bioinspirada que se fusiona, se vincula y se desvanece con el tiempo; disponible mediante MCP y compatible con las skills de OpenClaw.

Estrellas
50
Forks
8
Issues abiertos
0
Último commit
hace 6 días

¿Qué es?

ScallopBot es un agente de IA personal que se ejecuta en tu propio servidor y se comunica contigo por Telegram, un panel web, una CLI o canales como Discord, Slack, WhatsApp, Signal y Matrix. Su memoria se almacena en un único archivo SQLite y combina búsquedas por palabras clave con BM25, embeddings y reordenamiento opcional mediante LLM. Los recuerdos se degradan según su categoría, se fusionan en resúmenes y los elementos de poca utilidad se archivan de forma reversible antes de depurarlos.

Un proceso en segundo plano ejecuta periódicamente la degradación y auditorías, además de un ciclo nocturno que consolida recuerdos, realiza una autorreflexión y busca tareas pendientes o fechas límite próximas. Las llamadas a modelos se cobran por token y se dirigen a niveles rápido, estándar o avanzado, con conmutación por error entre siete proveedores de LLM y límites de gasto diarios y mensuales.

El agente puede usar cualquier servidor MCP y expone su propia memoria como servidor MCP para que clientes como Claude Code o Codex puedan leer y escribir en el mismo almacén. Las skills usan el formato SKILL.md de OpenClaw, y el proyecto publica en su README un benchmark frente a otros agentes.

Funciones clave

  • 01Memoria que se degrada, se fusiona y se archiva con el tiempo, con recuperación que combina BM25 y embeddings.
  • 02Enrutamiento con control de costos entre siete proveedores de LLM, con conmutación por error y límites de gasto diarios y mensuales.
  • 03Compatibilidad bidireccional con MCP: consume servidores MCP y ofrece herramientas de memoria a otros clientes.
  • 04Consolidación nocturna en segundo plano, autorreflexión y búsqueda proactiva de lagunas.
  • 05Compatible con skills al estilo de OpenClaw y agentskills.io, con 34 skills incluidas.
  • 06Opciones locales de transcripción y síntesis de voz, además de un panel web que se puede instalar como aplicación.

Casos de uso

  • Ejecutar un asistente privado y siempre disponible en un servidor doméstico o una Raspberry Pi, y acceder a él mediante Telegram.
  • Compartir una memoria persistente entre el asistente de chat y herramientas de programación como Claude Code mediante MCP.
  • Mantener predecible el gasto en LLM mediante el enrutamiento de solicitudes entre modelos más económicos y más potentes, con límites de presupuesto.
  • Experimentar con diseños de memoria para agentes que vayan más allá del simple almacenamiento de notas.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/tashfeenahmed/scallopbot.git
  2. 2

    Entra en la carpeta e instala las dependencias

    cd scallopbot && npm install
  3. 3

    Copia .env.example en .env, añade al menos una clave API de un proveedor de LLM y luego compila

    npm run build
  4. 4

    Inicia el bot; el panel está disponible en http://localhost:3000

    node dist/cli.js start

Antes de usarlo

  • Requiere Node.js 24 o posterior.
  • Para ejecutarlo, necesitas al menos una clave API de un proveedor de LLM de pago.
  • Aún no está publicado en el registro de npm, así que debes compilarlo desde un clon.

Temas

Preguntas frecuentes

¿Qué es scallopbot?
Asistente de IA personal y autohospedado con memoria bioinspirada que se fusiona, se vincula y se desvanece con el tiempo; disponible mediante MCP y compatible con las skills de OpenClaw. ScallopBot es un agente de IA personal que se ejecuta en tu propio servidor y se comunica contigo por Telegram, un panel web, una CLI o canales como Discord, Slack, WhatsApp, Signal y Matrix. Su memoria se almacena en un único archivo SQLite y combina búsquedas por palabras clave con BM25, embeddings y reordenamiento opcional mediante LLM. Los recuerdos se degradan según su categoría, se fusionan en resúmenes y los elementos de poca utilidad se archivan de forma reversible antes de depurarlos.
¿scallopbot es gratuito? ¿Qué licencia tiene?
scallopbot es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿scallopbot sigue mantenido?
Mantenimiento activo. El último commit de scallopbot fue el 16 oct 2026.
¿Para qué puedo usar scallopbot?
Ejecutar un asistente privado y siempre disponible en un servidor doméstico o una Raspberry Pi, y acceder a él mediante Telegram. Compartir una memoria persistente entre el asistente de chat y herramientas de programación como Claude Code mediante MCP. Mantener predecible el gasto en LLM mediante el enrutamiento de solicitudes entre modelos más económicos y más potentes, con límites de presupuesto. Experimentar con diseños de memoria para agentes que vayan más allá del simple almacenamiento de notas.
¿Cómo se instala scallopbot?
Clona el repositorio: git clone https://github.com/tashfeenahmed/scallopbot.git Entra en la carpeta e instala las dependencias: cd scallopbot && npm install Copia .env.example en .env, añade al menos una clave API de un proveedor de LLM y luego compila: npm run build Inicia el bot; el panel está disponible en http://localhost:3000: node dist/cli.js start
¿Dónde consigo scallopbot?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/tashfeenahmed/scallopbot

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados