Trackio documentation

Hospede o servidor do Trackio

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Hospede o servidor do Trackio

Você pode executar o dashboard e a API do Trackio na sua própria máquina (ou em qualquer host que você controle) e enviar métricas dos scripts de treinamento para esse servidor via HTTP. Esta é uma alternativa para registrar em um Hugging Face Space via space_id.

Execute o servidor localmente

Instale o Trackio e, em seguida, inicie o dashboard. Por padrão, ele escuta em 127.0.0.1 e usa a porta de GRADIO_SERVER_PORT, se definida; caso contrário, usa 7860 (veja Iniciar o Dashboard).

Shell
Python
trackio show

Mantenha esse processo em execução durante o treinamento. O terminal exibe uma URL base para a interface do usuário e uma URL que inclui um write token; qualquer pessoa que consiga acessar essa URL com o token pode executar operações de gravação suportadas pelo servidor (por exemplo, renomear execuções), portanto, trate-o como um segredo em redes não confiáveis.

Ouvir em todas as interfaces

Para acessar o dashboard a partir de outra máquina na sua rede (ou de contêineres), vincule a todas as interfaces:

Shell
Python
trackio show --host 0.0.0.0

Certifique-se de que seu firewall e suas políticas de segurança permitam o tráfego pretendido.

Aponte o código de treinamento para o seu servidor

No script de treinamento, passe um server_url e forneça o token de escrita: incorpore o write_token na string de consulta (a mesma URL que o dashboard exibe para acesso de escrita, ou o valor de retorno full_url de trackio.show()), ou passe uma URL base como http://127.0.0.1:7860/ e defina a variável de ambiente TRACKIO_WRITE_TOKEN com esse token. Você também pode definir TRACKIO_WRITE_TOKEN no servidor Trackio antes de iniciar o trackio.show() para escolher o token de escrita do servidor em vez de usar o token aleatório gerado na inicialização. A ingestão de métricas e os uploads exigem esse token quando o servidor não está nos Hugging Face Spaces. Você também pode definir TRACKIO_SERVER_URL em vez de passar server_url no código.

import trackio

trackio.init(
    project="my-project",
    server_url="http://127.0.0.1:7860?write_token=YOUR_TOKEN",
)
trackio.log({"loss": 0.25})
trackio.finish()

Precedência: space_id / TRACKIO_SPACE_ID sempre tem precedência sobre server_url / TRACKIO_SERVER_URL quando ambos estão definidos (no código ou no ambiente). O Trackio então se comporta como se apenas o Space estivesse configurado.

Opções específicas do Hugging Face, como dataset_id (obsoleto; use bucket_id em vez disso) e bucket_id, se aplicam apenas ao registrar em um Space. Quando apenas server_url está em vigor, configure a persistência na máquina onde o servidor é executado (por exemplo, via TRACKIO_DIR naquele host). Consulte Variáveis de Ambiente.

Relacionados

Update on GitHub