Usar o DeepSeek no Hermes

O Hermes acessa os modelos da DeepSeek pelo provedor deepseek, que fala direto com a API da empresa. A autenticação usa uma chave de API guardada na variável DEEPSEEK_API_KEY, no arquivo ~/.hermes/.env do usuário que roda o agente. Esse arquivo fica fora do config.yaml, onde ficam apenas o provedor e o modelo escolhidos.

O comando hermes model faz as duas partes de uma vez. Ele abre a lista de provedores, recebe a chave no terminal e grava o modelo padrão em model.provider e model.default no config.yaml. A documentação do Hermes não fixa um nome de modelo da DeepSeek, então a escolha acontece na lista que o próprio comando mostra.

Grave a chave de API

Crie a chave de API no painel da DeepSeek e copie o valor. Na VPS, abra a sessão do usuário hermes e rode o assistente de modelo:

1
sudo -iu hermes
2
hermes model

Escolha DeepSeek na lista de provedores e cole a chave no campo que o assistente mostra. Em seguida, selecione o modelo padrão. Colar a chave no assistente evita que ela apareça no histórico do shell, o que aconteceria com a chave digitada como argumento de um comando.

Mande a primeira mensagem

Abra a TUI com o usuário hermes e mande uma mensagem curta:

1
hermes --tui

Quando a resposta chega, o modelo está ligado. O comando /model, digitado na conversa, mostra o provedor e o modelo da sessão. A mesma informação fica no config.yaml, nas chaves model.provider e model.default.

Quando o Hermes responde com API key not set, a chave não chegou ao .env do profile em uso. Rode o hermes model de novo com o usuário hermes e confira se a sessão aberta é a do mesmo profile.

Troque de modelo sem gravar a chave de novo

A chave continua no .env quando o modelo muda. Na conversa, o comando /model troca o modelo só da sessão atual. Para trocar o modelo padrão, rode o hermes model e escolha outro modelo da DeepSeek na lista. A troca de provedor também preserva a chave, então voltar para a DeepSeek depois dispensa colar o valor outra vez.

Depois de atualizar o Hermes

Depois de uma atualização do Hermes, uma configuração ausente aparece no hermes config check. O comando hermes config migrate grava as opções novas no config.yaml sem apagar as que já existem.