Olá! Entendo perfeitamente a sua frustração. Esse erro específico ('state' key is missing from 'metadata.widgets') geralmente acontece por uma incompatibilidade na forma como o GitHub tenta renderizar arquivos Jupyter Notebook que possuem metadados de widgets (como barras de progresso ou botões interativos).
O arquivo não está necessariamente "quebrado", mas o visualizador nativo do GitHub não está conseguindo exibi-lo no momento. Para você conseguir baixar e utilizar o projeto.ipynb agora mesmo, siga estes passos:
1. Baixe o arquivo manualmente
Em vez de tentar abrir o arquivo diretamente no GitHub, faça o download para sua máquina:
- Na página do arquivo no GitHub, procure o botão "Download raw file" (um ícone de seta para baixo ou um botão escrito "Raw").
- Clique com o botão direito e selecione "Salvar link como...". Certifique-se de que a extensão final do arquivo seja
.ipynb.
2. Utilize o NBViewer
Se você quiser apenas visualizar o código sem baixar, pode usar uma ferramenta externa:
- Copie a URL do arquivo no GitHub.
- Acesse o NBViewer.
- Cole o link e clique em Go!. Ele costuma renderizar notebooks que o GitHub falha em mostrar.
3. Abra no Google Colab ou VS Code
Como você está no curso de RAG e Agentes de IA, provavelmente usará um ambiente de execução:
- Google Colab: Vá em
Arquivo -> Fazer upload de notebook e selecione o arquivo que você baixou. - VS Code: Abra o arquivo baixado diretamente no VS Code (com a extensão do Jupyter instalada). Ele deve abrir normalmente, ignorando o erro de metadados que o GitHub apontou.
Dica extra: Se você estiver tentando acessar via repositório da Alura, verifique se há uma pasta de "assets" ou se o link para o notebook foi atualizado no campo de "Arquivos do curso" dentro da plataforma.
Espero que isso destrave seu estudo! Qualquer outra dúvida sobre a configuração do ambiente para o curso de RAG, é só chamar.