Infraestrutura open source para agentes que oferece a um assistente de IA memória persistente, tarefas agendadas e canais de mensagens como Telegram e Lark.
cosmicstack-labs/mercury-agent
Agente de IA auto-hospedado, com memória local, ferramentas sujeitas a permissões e acesso por CLI, Telegram, Discord ou Slack.
- Estrelas
- 3,881
- Forks
- 399
- Issues abertas
- 20
- Último commit
- ontem
O que é?
O Mercury Agent é um agente de IA em TypeScript que roda como um único processo em segundo plano na sua máquina — macOS, Linux, Windows ou Android via Termux. Ele é instalado como um serviço de login, reinicia após uma falha e oferece o mesmo agente e a mesma memória pelo terminal, Telegram, Discord, Slack, Signal ou por um painel web local vinculado a 127.0.0.1.
O que ele acrescenta às ferramentas comuns de arquivos, shell e web é uma camada de governança: uma lista fixa de comandos de shell bloqueados que não pode ser sobrescrita, permissões de leitura e gravação por pasta, solicitações de aprovação, requisições protegidas contra SSRF e remoção de segredos dos logs. O Second Brain armazena fatos tipados e deduplicados em um banco de dados SQLite local, com busca de texto completo, e recupera os fatos relevantes antes de cada resposta. Além disso, um limite diário de tokens restringe cada interação. Há fallback entre provedores como DeepSeek, OpenAI, Anthropic, Ollama, LM Studio e qualquer endpoint compatível com OpenAI.
Dois modos ampliam os recursos principais: o Mercury Code planeja e desenvolve dentro de um repositório e só informa que uma tarefa foi concluída quando um build, teste ou typecheck passa; já o Mercury Bots oferece especialistas persistentes, com persona, permissões e orçamento próprios, que rodam em horários programados e entregam os arquivos finalizados em uma pasta local. O pacote inclui cerca de 50 ferramentas, além de skills da comunidade que podem ser instaladas e um agendador no estilo cron.
Recursos principais
- 01Camada de permissões com lista fixa de comandos de shell bloqueados, permissões de leitura e gravação por pasta, modos Ask Me ou Allow All por sessão e busca de URLs protegida contra SSRF.
- 02Memória Second Brain: dez tipos de fatos extraídos automaticamente para um banco de dados SQLite local, com busca de texto completo, consolidação a cada hora e inspeção por `/memory`.
- 03Acesso multicanal a um único runtime pelo terminal, Telegram, Discord, Slack, Signal e painel web em localhost com chat, Kanban e painel de controle dos bots.
- 04O Mercury Code trabalha em um repositório com um plano atualizado em tempo real e só marca as tarefas como concluídas depois que um build, teste ou typecheck passa.
- 05O Mercury Bots funciona como especialistas persistentes e agendados, individualmente ou em grupos com tarefas delegadas, orçamentos por bot e entrega de arquivos.
- 06Fallback entre DeepSeek, OpenAI, Anthropic, Grok, Ollama, LM Studio e qualquer endpoint compatível com OpenAI, além de um limite diário de tokens com o modo Token Saver.
- 07Cerca de 50 ferramentas integradas para arquivos, shell, git, GitHub, agendamento, subagentes e Spotify, com skills instaláveis em skills.mercuryagent.sh.
Casos de uso
- Usar um assistente pessoal que mantém a própria memória e continua trabalhando mesmo depois que você fecha o laptop.
- Permitir que um agente edite código em um repositório com solicitações de aprovação e verificação antes de informar que terminou.
- Acessar um único agente por um canal compartilhado do Telegram ou Discord, com permissões por função para administradores e membros.
- Agendar tarefas recorrentes de pesquisa ou geração de relatórios que entregam arquivos em uma pasta local ou no chat.
- Manter prompts, chaves e dados de conversas no seu próprio disco, em vez de usar um serviço hospedado.
Início rápido
- 1
Instale via npm (Node.js 22 ou superior)
npm i -g @cosmicstack/mercury-agent - 2
Execute o Mercury e conclua o assistente de configuração
mercury
Antes de usar
- Os scripts de instalação são transmitidos pela web, então o instalador de uma linha exige que você confie em um script externo.
- As skills da comunidade não são auditadas e devem ser revisadas antes da instalação.
- Para usar todos os recursos, é necessário ter chaves de API de um provedor de LLM ou uma conta do Mercury Cloud.
Em coleções
Tópicos
Perguntas frequentes
- O que é mercury-agent?
- Agente de IA auto-hospedado, com memória local, ferramentas sujeitas a permissões e acesso por CLI, Telegram, Discord ou Slack. O Mercury Agent é um agente de IA em TypeScript que roda como um único processo em segundo plano na sua máquina — macOS, Linux, Windows ou Android via Termux. Ele é instalado como um serviço de login, reinicia após uma falha e oferece o mesmo agente e a mesma memória pelo terminal, Telegram, Discord, Slack, Signal ou por um painel web local vinculado a 127.0.0.1.
- mercury-agent é gratuito? Qual é a licença?
- mercury-agent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- mercury-agent ainda é mantido?
- Manutenção ativa. O último commit de mercury-agent foi em 6 de nov. de 2026.
- Para que posso usar mercury-agent?
- Usar um assistente pessoal que mantém a própria memória e continua trabalhando mesmo depois que você fecha o laptop. Permitir que um agente edite código em um repositório com solicitações de aprovação e verificação antes de informar que terminou. Acessar um único agente por um canal compartilhado do Telegram ou Discord, com permissões por função para administradores e membros. Agendar tarefas recorrentes de pesquisa ou geração de relatórios que entregam arquivos em uma pasta local ou no chat. Manter prompts, chaves e dados de conversas no seu próprio disco, em vez de usar um serviço hospedado.
- Como instalar mercury-agent?
- Instale via npm (Node.js 22 ou superior): npm i -g @cosmicstack/mercury-agent Execute o Mercury e conclua o assistente de configuração: mercury
- Onde consigo mercury-agent?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cosmicstack-labs/mercury-agent
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um assistente pessoal de IA self-hosted, com memória visível e um workspace para o agente de código Pi, acessível pelo navegador, celular e WeChat.
Plataforma de agentes de IA multiusuário e auto-hospedada, onde equipes compartilham agentes especializados acessíveis pelo Telegram, Discord, Feishu e outros apps de chat.
Assistente pessoal de IA local-first, feito em Python legível, com loop de agente próprio, memória baseada em SQLite e evals integradas.
Plataforma de assistente pessoal de IA auto-hospedada e focada em privacidade, com agentes autônomos, mais de 250 ferramentas, suporte a MCP e integração com Telegram e WhatsApp.
Fork open source do NagramX que reimplementa os recursos do exteraGram para Android e oferece um modelo de permissões para plugins.