Wellness Nourish: pesquisa e registo nutricional local (sem OAuth)

Para quem

Se quiser consultar alimentos, códigos de barras, registar uma refeição ou água no próprio computador e não quiser OAuth, Wellness Nourish serve para esse tipo de tarefa nutricional local. A documentação oficial chama-o de serviço nutricional «local-first»: pesquisa de alimentos, consulta de código de barras, registo de ingestão e água, e diz que pode funcionar sem OAuth. Um limite mais duro: os tokens não saem da sua máquina.

Dirige-se a quem está pronto para executar um comando oficial de instalação num terminal e fazer de imediato uma pesquisa de baixo risco, não a quem só quer ler uma definição de produto. Oficialmente pode ligar este conector sozinho ao Claude Desktop, Cursor ou ChatGPT Desktop. Isso são alvos de cablagem, não um segundo caminho principal de instalação. Se ligar sozinho, termine primeiro a instalação oficial abaixo e depois confirme que o conector aparece nesse cliente.

Se precisar de parâmetros de código de barras, campos de ingestão, uma interface de escrita de água ou um método de desfazer que o texto oficial ainda não escreveu, a descrição atual não chega lá. Não trate isso como um procedimento já pronto. Local-first só significa que os tokens ficam nesta máquina. Não equivale automaticamente a ausência de leituras ou escritas locais, nem a uma instalação que nunca toca a rede.

Primeira tentativa em 3 minutos

Use só este caminho oficial de instalação.

Pré-requisito: esta máquina consegue executar npx. Não precisa solicitar OAuth. Oficialmente os tokens não saem desta máquina. Lembre também: a instalação muda a configuração local, e a demo offline ainda chama um pacote publicado.

Local de instalação e configuração: execute este comando oficial num terminal. Oficialmente ele pré-escreve este conector e a pilha Delx Wellness completa num ficheiro de configuração dedicado.

npx -y delx-wellness-hermes setup

A primeira chamada deve nomear a ferramenta oficial de pesquisa. Não faça primeiro escritas de ingestão ou água. Execute este comando de fixture offline. A ferramenta é search, o termo é banana, e conserve o interruptor offline:

NOURISH_FIXTURE_MODE=1 npx -y wellness-nourish search banana

O interruptor offline deve permanecer. A fixture vem com o pacote publicado e resolve-se a partir da raiz do pacote. O sucesso tem duas camadas: o comando de instalação termina e escreve o ficheiro dedicado; depois esta pesquisa de alimento completa-se e a demo de fixture offline funciona. Oficialmente não há inventário de campos devolvidos. Basta confirmar que ocorreu uma pesquisa. Se o comando falhar ou não houver saída de pesquisa, pare aqui. Não mude para registar refeição ou água.

Casos de uso

Caso 1: primeiro confirmar que a pesquisa de alimentos corre nesta máquina. A única chamada oficial que escreve ao mesmo tempo nome de ferramenta e parâmetros é o search banana acima com interruptor offline. O propósito é confirmar que o pacote wellness-nourish publicado encontra a fixture incluída e termina uma pesquisa de alimento. Pare ao ver um resultado para banana. Oficialmente não se diz quais campos nutricionais voltam. Não invente esses detalhes nem leia este passo como uma refeição já registada.

Caso 2: consulta de código de barras, ou estimar uma refeição brasileira. Oficialmente, consulta de código de barras, registo de ingestão e água estão na mesma frase de capacidades. 0.7.0 também escreve estimativas de refeição TACO 4 para alimentos brasileiros em português, com exemplos cafezinho, feijão, concha e churrasco-style meals. Ambas as necessidades encaixam em capacidades escritas, mas não há nome de ferramenta de código de barras, nem de estimativa, nem tabela de parâmetros. Hoje só pode dizer que a página afirma estas capacidades, não como chamá-las nem o que escrevem. Registo de ingestão e água são claramente escritas. Não as execute até ver ferramentas nomeadas oficialmente no cliente. Também não há caminho de desfazer ou rollback, por isso não diga que as escritas são reversíveis.

Limites de uso

Local-first e sem OAuth. Os tokens não saem desta máquina. Não infira daí: sem rede, sem leituras locais ou sem fronteira de privacidade. O comando de instalação muda um ficheiro dedicado. A demo offline ainda chama um pacote publicado com npx. Mesmo que a primeira tentativa seja só pesquisa, esta máquina executa um pacote externo e pode ler ficheiros de fixture do pacote.

A instalação oficial de um clique pré-configura este conector e a pilha Delx Wellness completa. Este texto não desenvolve nenhum segundo comando de instalação, para não escrever estilos concorrentes como caminhos principais em paralelo.

A demo offline depende de fixtures do pacote e deve levar o interruptor offline escrito oficialmente. TACO 4 só cobre as cenas de comida brasileira em português nomeadas oficialmente. Não o estenda a uma biblioteca de ingredientes não escrita. Código de barras, ingestão e água são só nomes de capacidade, sem formato de chamada. Pode ligá-lo sozinho ao Claude Desktop, Cursor ou ChatGPT Desktop, mas a cablagem segue a interface de cada cliente. Essa frase oficial não dá um fragmento de configuração.

Página de documentação: https://github.com/davidmosiah/wellness-nourish