tashfeenahmed/scallopbot

O que é?

Recursos principais

• 01Memória que perde relevância, se funde e é arquivada com o tempo, com recuperação que combina BM25 e embeddings.
• 02Roteamento com foco em custos entre sete provedores de LLM, com failover e limites de orçamento diários e mensais.
• 03Suporte bidirecional a MCP: usa servidores MCP e disponibiliza ferramentas de memória para outros clientes.
• 04Consolidação noturna em segundo plano, autorreflexão e busca proativa por lacunas.
• 05Compatível com skills no estilo OpenClaw e agentskills.io, com 34 skills incluídas.
• 06Opções locais de transcrição e síntese de voz, além de um painel web que pode ser instalado como app.

Casos de uso

• Executar um assistente privado sempre ativo em um servidor doméstico ou Raspberry Pi e acessá-lo pelo Telegram.
• Compartilhar uma memória persistente entre o assistente de chat e ferramentas de programação como Claude Code via MCP.
• Manter os gastos com LLM previsíveis, direcionando solicitações para modelos mais baratos ou mais avançados, com limites de orçamento.
• Experimentar designs de memória para agentes que vão além do simples armazenamento de notas.

Início rápido

1. 1

   Clone o repositório

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

   Acesse a pasta e instale as dependências

   cd scallopbot && npm install
3. 3

   Copie .env.example para .env, adicione pelo menos uma chave de API de um provedor de LLM e, em seguida, faça o build

   npm run build
4. 4

   Inicie o bot; o painel fica disponível em http://localhost:3000

   node dist/cli.js start

Antes de usar

• !Requer Node.js 24 ou superior.
• !Para executar, é necessária pelo menos uma chave de API de um provedor de LLM pago.
• !Ainda não foi publicado no registro npm, então é preciso fazer o build a partir de um clone.

Tópicos

Perguntas frequentes

O que é scallopbot?

Assistente pessoal de IA auto-hospedado, com memória bioinspirada que se funde, se conecta e se dissipa com o tempo, acessível via MCP e compatível com skills do OpenClaw. ScallopBot é um agente pessoal de IA que roda no seu próprio servidor e conversa com você pelo Telegram, por um painel web, por uma CLI ou por canais como Discord, Slack, WhatsApp, Signal e Matrix. Sua memória fica em um único arquivo SQLite e combina busca por palavras-chave BM25 com embeddings e reclassificação opcional por LLM. As memórias perdem força conforme a categoria, são fundidas em resumos e, antes de serem removidas, os itens de baixa utilidade são arquivados de forma reversível.

scallopbot é gratuito? Qual é a licença?

scallopbot é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

scallopbot ainda é mantido?

Manutenção ativa. O último commit de scallopbot foi em 16 de out. de 2026.

Para que posso usar scallopbot?

Executar um assistente privado sempre ativo em um servidor doméstico ou Raspberry Pi e acessá-lo pelo Telegram. Compartilhar uma memória persistente entre o assistente de chat e ferramentas de programação como Claude Code via MCP. Manter os gastos com LLM previsíveis, direcionando solicitações para modelos mais baratos ou mais avançados, com limites de orçamento. Experimentar designs de memória para agentes que vão além do simples armazenamento de notas.

Como instalar scallopbot?

Clone o repositório: git clone https://github.com/tashfeenahmed/scallopbot.git Acesse a pasta e instale as dependências: cd scallopbot && npm install Copie .env.example para .env, adicione pelo menos uma chave de API de um provedor de LLM e, em seguida, faça o build: npm run build Inicie o bot; o painel fica disponível em http://localhost:3000: node dist/cli.js start

Onde consigo scallopbot?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tashfeenahmed/scallopbot