Olá, Igor! Como vai?
O erro indica que o comando uvicorn não esta disponível no PATH do seu ambiente, mesmo com o pacote instalado via pip.
No Windows, quando o Python e instalado no modo user, o executável do uvicorn fica dentro da pasta Scripts, que normalmente não está configurada no PATH.
Pontos importantes para resolver:
Opcao 1 – Executar o uvicorn usando python -m (mais simples e recomendado)
Veja este exemplo:
python -m uvicorn main:app --reload
Esse comando chama o uvicorn como modulo do Python, evitando o problema de PATH.
Ele inicia o servidor e recarrega automaticamente ao alterar o codigo.
Opcao 2 – Adicionar a pasta Scripts ao PATH do Windows
Resolva fazendo o seguinte:
Copie o caminho parecido com este:
C:\Users\igor_bairros\AppData\Roaming\Python\Python312\Scripts
No Windows, abra:
Configurações > Sistema > Sobre > Configurações avançadas do sistema
Em Variáveis de Ambiente, edite a variável Path e adicione esse caminho.
Feche o terminal, abra novamente e rode:
uvicorn main:app --reload
Esse comando sobe a API FastAPI usando o arquivo main.py e o objeto app, permitindo testes locais no navegador.
Espero ter ajudado. Conte com o apoio do Fórum na sua jornada. Fico à disposição.
Caso este post tenha lhe ajudado, por favor, marcar como solucionado ✓.