Knotwork: build your agent

Alexey Volodin

Sobre este app

O Knotwork é um agente de IA que executa seu modelo no celular. Em vez de uma caixa de diálogo conectada à API de alguém, cada conversa passa por um fluxo que você pode abrir e editar: um grafo de nós tipados — entrada, LLM no dispositivo, LLM opcional na nuvem, chamada de ferramenta, roteamento, decomposição, avaliação, esclarecimento e saída. Quando uma etapa precisa realizar algo destrutivo ou sensível, ela para e pede sua permissão primeiro — inclusive em segundo plano, onde a confirmação chega como uma notificação.

COMO FUNCIONA

- Executa no seu dispositivo. Inferência no dispositivo por meio do LiteRT-LM, com aceleração opcional de NPU/GPU; funciona apenas com CPU, porém é mais lento. Os provedores de nuvem (OpenAI, Anthropic, Google Gemini, DeepSeek, Ollama) são opcionais, exigem ativação e o usuário fornece sua própria chave.

- Você cria o comportamento. Um editor de arrastar e soltar com panorâmica e zoom com os dedos, ajuste à grade, layout automático, validação embutida e uma sobreposição de rastreamento de execução, em 14 tipos de nós. Variáveis ​​de prompt como $DATE, $TIME, $TOOLS, $MODEL e $MEMORY_SUMMARY são atualizadas a cada execução.
- Ferramentas controladas por você. Ações locais por meio de AppFunctions e servidores externos por meio do Protocolo de Contexto do Modelo (MCP). Toda chamada sensível ou destrutiva é interrompida para confirmação explícita, imposta no local onde a ferramenta é executada, e não apenas sugerida ao modelo.

- Acesso externo ao aplicativo. Um destino de compartilhamento, atalhos no iniciador e um bloco de Configurações Rápidas executam o pipeline escolhido sobre textos ou imagens compartilhados. Gatilhos (hora, carregamento, Wi-Fi, rede) disparam um pipeline automaticamente e enviam um relatório. Cada superfície de entrada permanece inerte até que você vincule um pipeline a ela.

- Memoriza o que importa. Memória de longo prazo com recuperação semântica de conversas anteriores, extração automática de fatos, pesquisa e exportação.

PARA QUEM É INDICADO

É para quem já utiliza Tasker, Obsidian, Home Assistant ou um modelo local em seu próprio hardware e deseja saber exatamente o que seu agente faz com seus dados. Não se trata de um assistente para o mercado de massa do tipo "faça uma pergunta e obtenha uma resposta" — o Gemini é gratuito e integrado ao sistema operacional, e competir com ele seria uma aposta perdida.

PRIVACIDADE

Não há conta, login ou servidor próprio. A inferência é executada no próprio telefone, portanto, uma conversa normal nunca sai dele. Os dados são enviados apenas por um caminho que você mesmo construiu: um nó na nuvem com sua própria chave ou um servidor MCP que você adicionou — ambos visíveis no pipeline. As estatísticas de uso permanecem no dispositivo e nunca são transmitidas; uma verificação em tempo de compilação falha se qualquer dependência de rede atingir esse código. O banco de dados — chats, memória, rastreamentos de execução — é criptografado com SQLCipher e as chaves da API são protegidas por uma chave do Android Keystore. O relatório de falhas é opcional, desativado por padrão e está totalmente ausente da versão FOSS.

LIMITAÇÕES CONHECIDAS

Esta é uma versão prévia. A interface pública, o layout das configurações e os formatos de armazenamento no dispositivo ainda podem mudar entre as versões.

- Android 14 ou superior e cerca de 2 GB de RAM livre - a memória é a verdadeira limitação.
- Os arquivos de pipeline compartilhados ainda não são um contrato de compatibilidade: as exportações carregam um carimbo de versão, mas antes da versão 1.0 esse carimbo é apenas um marcador, não uma garantia. Mantenha o original.
- Os números de confiabilidade vêm de um dispositivo e uma operadora: um pipeline agendado foi executado por 7,14 dias sem que o aplicativo fosse aberto e completou 55 de 55 execuções sem falhas inexplicáveis. Essa é uma medição real e não uma validação externa.

- As execuções em segundo plano exigem que a configuração de bateria esteja definida como "Sem restrições". Sem ela, o Android recupera o processo em cerca de dez segundos - uma regra da plataforma, não um bug, mas até que você a conceda, os pipelines em segundo plano não serão executados.

- O comportamento em caso de falha na nuvem varia de acordo com o provedor: a detecção de um fluxo que é interrompido no meio da resposta é habilitada apenas onde foi medida.

- Aplicativos de terceiros não podem expor AppFunctions - somente os aplicativos de sistema do fabricante do dispositivo e o Google podem. O catálogo de ferramentas local é o que é fornecido, além de tudo o que você conectar via MCP. - Um único mantenedor, sem empresa por trás.

Código aberto sob a Licença Apache 2.0; o código-fonte e a documentação estão disponíveis no site do desenvolvedor.

O que há de novo

Another app can now run a pipeline for you. Tasker, MacroDroid or a shell script over adb can ask Knotwork to run the one pipeline you nominate. It is off by default, opens only with an explicit yes, and every request is recorded.

Background runs now have ceilings on steps and tokens, so an unattended loop cannot quietly spend your cloud API key, and a run that stops explains why.

Knotwork now installs on Android 14 and 15, not only 16.

A prompt can be exported and imported as a file.