Trackio documentation
Hospede o servidor do Trackio
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).
trackio show
import trackio
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:
trackio show --host 0.0.0.0
import trackio
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
- Iniciar o Dashboard — opções de CLI, porta e acesso remoto
- Variáveis de ambiente —
TRACKIO_SERVER_URL,TRACKIO_DIRe outras