Git via SSH

Você pode acessar e gravar dados em repositórios no huggingface.co usando SSH (Secure Shell Protocol). Ao se conectar via SSH, você autentica usando um arquivo de chave privada na sua máquina local.

Algumas ações, como enviar alterações ou clonar repositórios privados, exigirão que você envie sua chave pública SSH para sua conta no huggingface.co.

Você pode usar uma chave SSH existente ou gerar uma nova especificamente para o huggingface.co.

Verificando chaves SSH existentes

Se você já possui uma chave SSH, pode usar essa chave para autenticar operações do Git via SSH.

As chaves SSH geralmente estão localizadas em ~/.ssh no Mac e no Linux, e em C:\\Users\\<username>\\.ssh no Windows. Liste os arquivos nesse diretório e procure por arquivos no formato:

• id_rsa.pub
• id_ecdsa.pub
• id_ed25519.pub

Esses arquivos contêm sua chave pública SSH.

Se você não tiver esse arquivo em ~/.ssh, será necessário gerar uma nova chave. Caso contrário, você pode adicionar sua(s) chave(s) pública(s) SSH existente(s) à sua conta no huggingface.co.

Gerando um novo par de chaves SSH

Se você não tiver nenhuma chave SSH em sua máquina, pode usar ssh-keygen para gerar um novo par de chaves SSH (chaves pública e privada):

$ ssh-keygen -t ed25519 -C "your.email@example.co"

Recomendamos que você insira uma senha de passagem quando solicitado. Uma senha de passagem é uma camada extra de segurança: é uma senha que será solicitada sempre que você usar sua chave SSH.

Depois que a sua nova chave for gerada, adicione-a ao seu agente SSH com ssh-add:

$ ssh-add ~/.ssh/id_ed25519

Se você escolheu um local diferente do padrão para armazenar sua chave SSH, precisaria substituir ~/.ssh/id_ed25519 pelo local do arquivo que você usou.

Adicione uma chave SSH à sua conta

Para acessar repositórios privados via SSH ou para enviar alterações via SSH, você precisa adicionar sua chave pública SSH à sua conta no huggingface.co. Você pode gerenciar suas chaves SSH nas configurações do seu usuário.

Para adicionar uma chave SSH à sua conta, clique no botão “Add SSH key”.

Em seguida, insira um nome para esta chave (por exemplo, “Computador pessoal”) e copie e cole o conteúdo da sua chave SSH pública na área abaixo. A chave pública está localizada no arquivo ~/.ssh/id_XXXX.pub que você encontrou ou gerou nas etapas anteriores.

Clique em “Add key” e voilà! Você adicionou uma chave SSH à sua conta no huggingface.co.

Testando sua autenticação SSH

Depois de adicionar sua chave SSH à sua conta no huggingface.co, você pode testar se a conexão funciona como esperado.

Em um terminal, execute:

$ ssh -T git@hf.co

Se você vir uma mensagem com seu nome de usuário, parabéns! Tudo deu certo, você está pronto para usar o git via SSH.

Caso contrário, se a mensagem indicar algo como o seguinte, verifique se sua chave SSH está realmente em uso pelo seu agente SSH.

Hi anonymous, welcome to Hugging Face.

Impressões digitais das chaves SSH da Hugging Face

As impressões digitais de chaves públicas podem ser usadas para validar uma conexão com um servidor remoto.

Estas são as impressões digitais das chaves públicas da Hugging Face:

SHA256:aBG5R7IomF4BSsx/h6tNAUVLhEkkaNGB8Sluyh/Q/qY (ECDSA) SHA256:skgQjK2+RuzvdmHr24IIAJ6uLWQs0TGtEUt3FtzqirQ (DSA - descontinuado) SHA256:dVjzGIdV7d6cwKIeZiCoRMa2gMvSKfGZAvHf4gMiMao (ED25519) SHA256:uqjYymysBGCXXiMVebB8L8RIuWbPSKGBxQQNhcT5a3Q (RSA)

Você pode adicionar as seguintes entradas de chave ssh ao seu arquivo ~/.ssh/known_hosts para evitar a verificação manual dos hosts do Hugging Face:

hf.co ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDtPB+snz63eZvTrbMY2Qt39a6HYile89JOum55z3lhIqAqUHxLtXFd+q+ED8izQvyORFPSmFIaPw05rtXo37bm+ixL6wDmvWrHN74oUUWmtrv2MNCLHE5VDb3+Q6MJjjDVIoK5QZIuTStlq0cUbGGxQk7vFZZ2VXdTPqgPjw4hMV7MGp3RFY/+Wy8rIMRv+kRCIwSAOeuaLPT7FzL0zUMDwj/VRjlzC08+srTQHqfoh0RguZiXZQneZKmM75AFhoMbP5x4AW2bVoZam864DSGiEwL8R2jMiyXxL3OuicZteZqll0qfRlNopKnzoxS29eBbXTr++ILqYz1QFqaruUgqSi3MIC9sDYEqh2Q8UxP5+Hh97AnlgWDZC0IhojVmEPNAc7Y2d+ctQl4Bt91Ik4hVf9bU+tqMXgaTrTMXeTURSXRxJEm2zfKQVkqn3vS/zGVnkDS+2b2qlVtrgbGdU/we8Fux5uOAn/dq5GygW/DUlHFw412GtKYDFdWjt3nJCY8=
hf.co ssh-dss AAAAB3NzaC1kc3MAAACBAORXmoE8fn/UTweWy7tCYXZxigmODg71CIvs/haZQN6GYqg0scv8OFgeIQvBmIYMnKNJ7eoo5ZK+fk1yPv8aa9+8jfKXNJmMnObQVyObxFVzB51x8yvtHSSrL4J3z9EAGX9l9b+Fr2+VmVFZ7a90j2kYC+8WzQ9HaCYOlrALzz2VAAAAFQC0RGD5dE5Du2vKoyGsTaG/mO2E5QAAAIAHXRCMYdZij+BYGC9cYn5Oa6ZGW9rmGk98p1Xc4oW+O9E/kvu4pCimS9zZordLAwHHWwOUH6BBtPfdxZamYsBgO8KsXOWugqyXeFcFkEm3c1HK/ysllZ5kM36wI9CUWLedc2vj5JC+xb5CUzhVlGp+Xjn59rGSFiYzIGQC6pVkHgAAAIBve2DugKh3x8qq56sdOH4pVlEDe997ovEg3TUxPPIDMSCROSxSR85fa0aMpxqTndFMNPM81U/+ye4qQC/mr0dpFLBzGuum4u2dEpjQ7B2UyJL9qhs1Ubby5hJ8Z3bmHfOK9/hV8nhyN8gf5uGdrJw6yL0IXCOPr/VDWSUbFrsdeQ==
hf.co ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBL0wtM52yIjm8gRecBy2wRyEMqr8ulG0uewT/IQOGz5K0ZPTIy6GIGHsTi8UXBiEzEIznV3asIz2sS7SiQ311tU=
hf.co ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAINJjhgtT9FOQrsVSarIoPVI1jFMh3VSHdKfdqp/O776s