Repolode
cosmicstack-labs

cosmicstack-labs/mercury-agent

Agente de IA autoalojado con memoria local, herramientas sujetas a permisos y acceso desde CLI, Telegram, Discord o Slack.

Estrellas
3,881
Forks
399
Issues abiertos
20
Último commit
hace 22 horas

¿Qué es?

Mercury Agent es un agente de IA en TypeScript que se ejecuta como un único proceso en segundo plano en tu propio equipo —macOS, Linux, Windows o Android mediante Termux—. Se instala como servicio de inicio de sesión, se reinicia después de un fallo y ofrece el mismo agente y la misma memoria desde la interfaz de terminal, Telegram, Discord, Slack, Signal o un panel web local vinculado a 127.0.0.1.

Además de las habituales herramientas para archivos, shell y web, incorpora controles de gobernanza: una lista de bloqueo de shell que no se puede anular, permisos de lectura y escritura por carpeta, solicitudes de aprobación, peticiones fetch protegidas contra SSRF y ocultación de secretos en los registros. Second Brain almacena datos tipados y deduplicados en una base de datos SQLite local con búsqueda de texto completo y recupera los relevantes antes de cada respuesta; además, un límite diario de tokens restringe cada turno. Se prueban varios proveedores —entre ellos DeepSeek, OpenAI, Anthropic, Ollama y LM Studio—, con cualquier endpoint compatible con OpenAI como alternativa.

Dos modos amplían las funciones principales: Mercury Code planifica y construye dentro de un repositorio, y solo marca una tarea como completada si se supera una compilación, una prueba o una comprobación de tipos; Mercury Bots son especialistas persistentes con personalidad, permisos y presupuesto propios, que se ejecutan según una programación y entregan los archivos terminados en una carpeta local. Incluye unas 50 herramientas y también ofrece skills comunitarias instalables y un programador de tareas tipo cron.

Funciones clave

  • 01Capa de permisos con una lista fija de bloqueo de shell, permisos de lectura y escritura por carpeta, modos Ask Me o Allow All por sesión y recuperación de URL protegida contra SSRF.
  • 02Memoria Second Brain: extrae automáticamente diez tipos de datos y los guarda en una base de datos SQLite local con búsqueda de texto completo, consolidación cada hora e inspección mediante `/memory`.
  • 03Acceso multicanal a un único entorno de ejecución desde la interfaz de terminal, Telegram, Discord, Slack, Signal y un panel web en localhost con chat, Kanban y consola de bots.
  • 04Mercury Code trabaja en un repositorio con un plan en tiempo real y solo marca las tareas como completadas si se supera una compilación, una prueba o una comprobación de tipos.
  • 05Mercury Bots se ejecutan como especialistas persistentes con programación, individualmente o en flotas con tareas delegadas, presupuestos por bot y entrega de archivos.
  • 06Alternancia entre proveedores como DeepSeek, OpenAI, Anthropic, Grok, Ollama y LM Studio, además de cualquier endpoint compatible con OpenAI; incluye un límite diario de tokens y el modo Token Saver.
  • 07Unas 50 herramientas integradas para archivos, shell, git, GitHub, programación, subagentes y Spotify, además de skills instalables desde skills.mercuryagent.sh.

Casos de uso

  • Usar un asistente personal que conserve su memoria y siga trabajando aunque cierres el portátil.
  • Permitir que un agente edite código en un repositorio, con solicitudes de aprobación y verificaciones antes de informar que terminó correctamente.
  • Acceder a un mismo agente desde un canal compartido de Telegram o Discord, con permisos por rol para administradores y miembros.
  • Programar tareas periódicas de investigación o generación de informes que entreguen archivos en una carpeta local o en un chat.
  • Mantener los prompts, las claves y los datos de conversación en tu propio disco, en vez de usar un servicio alojado.

Inicio rápido

  1. 1

    Instala mediante npm (Node.js 22 o superior)

    npm i -g @cosmicstack/mercury-agent
  2. 2

    Ejecuta Mercury y completa el asistente de configuración

    mercury

Antes de usarlo

  • Los scripts de instalación se canalizan desde la web, por lo que el instalador de una sola línea requiere confiar en un script externo.
  • Las skills de la comunidad no se auditan y deben revisarse antes de instalarlas.
  • Para usar todas las funciones, necesitas claves de API de un proveedor de LLM o una cuenta de Mercury Cloud.

En colecciones

Temas

Preguntas frecuentes

¿Qué es mercury-agent?
Agente de IA autoalojado con memoria local, herramientas sujetas a permisos y acceso desde CLI, Telegram, Discord o Slack. Mercury Agent es un agente de IA en TypeScript que se ejecuta como un único proceso en segundo plano en tu propio equipo —macOS, Linux, Windows o Android mediante Termux—. Se instala como servicio de inicio de sesión, se reinicia después de un fallo y ofrece el mismo agente y la misma memoria desde la interfaz de terminal, Telegram, Discord, Slack, Signal o un panel web local vinculado a 127.0.0.1.
¿mercury-agent es gratuito? ¿Qué licencia tiene?
mercury-agent es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mercury-agent sigue mantenido?
Mantenimiento activo. El último commit de mercury-agent fue el 6 nov 2026.
¿Para qué puedo usar mercury-agent?
Usar un asistente personal que conserve su memoria y siga trabajando aunque cierres el portátil. Permitir que un agente edite código en un repositorio, con solicitudes de aprobación y verificaciones antes de informar que terminó correctamente. Acceder a un mismo agente desde un canal compartido de Telegram o Discord, con permisos por rol para administradores y miembros. Programar tareas periódicas de investigación o generación de informes que entreguen archivos en una carpeta local o en un chat. Mantener los prompts, las claves y los datos de conversación en tu propio disco, en vez de usar un servicio alojado.
¿Cómo se instala mercury-agent?
Instala mediante npm (Node.js 22 o superior): npm i -g @cosmicstack/mercury-agent Ejecuta Mercury y completa el asistente de configuración: mercury
¿Dónde consigo mercury-agent?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cosmicstack-labs/mercury-agent

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

Proyectos relacionados