Como instalar Python e configurar um ambiente virtual (venv) na sua hospedagem
Oi! Aqui é a Sensei da GeHost 🧘♀️ Se você chegou até aqui, provavelmente quer rodar uma aplicação Python — um bot, uma API, um scriptzinho de automação — dentro da sua hospedagem. Boa notícia: dá pra fazer isso de um jeito organizado, sem bagunçar as outras aplicações do seu domínio. O segredo é o ambiente virtual (venv). Vamos com calma, passo a passo.
Por que usar um ambiente virtual (venv)?
Pense no venv como uma "caixinha isolada" só para o seu projeto Python. Dentro dela ficam a versão do Python e as bibliotecas que a sua aplicação precisa — sem misturar com nada do resto da sua conta de hospedagem. Isso evita o clássico problema de "funcionava aqui, não funciona lá" e permite que você tenha, no futuro, mais de um projeto Python com versões e dependências diferentes, cada um na sua própria caixinha.
Passo a passo pelo cPanel (o jeito mais simples)
A sua hospedagem GeHost usa cPanel, e o cPanel já vem com uma ferramenta chamada "Configurar App Python" (Setup Python App), que cria o ambiente virtual pra você automaticamente — sem precisar digitar comando nenhum.
- Acesse o painel.gehost.com.br e entre no seu cPanel.
- Na home do cPanel, procure a seção de Software e clique em "Configurar App Python".
- Clique em "Criar Aplicativo" (Create Application).
- Escolha a versão do Python desejada e defina a pasta raiz do app (App root) e o domínio/URL onde ele vai rodar.
- Clique em Criar. Pronto: o cPanel já cria o ambiente virtual sozinho e mostra na tela um comando de ativação específico para o seu app.
- Para instalar as bibliotecas do seu projeto, use o campo de instalação de pacotes da própria tela (informando o nome do pacote ou um arquivo
requirements.txt) e clique em Update/Run Pip Install. - Depois de qualquer alteração, clique em "Restart" para a aplicação carregar as novidades.
💡 Dica da Sensei: guarde o comando de ativação que o cPanel mostra na tela do seu app — ele é único para cada aplicação e é a forma correta de "entrar" naquele venv específico depois, caso você use o terminal.
Ativando o venv manualmente (se o seu plano tiver Terminal liberado)
Alguns clientes preferem o caminho manual, digitando comandos. Isso é possível se o seu plano tiver acesso ao Terminal do cPanel liberado — confira essa disponibilidade no seu painel ou com o suporte.
- No cPanel, abra a ferramenta Terminal.
- Crie o ambiente virtual dentro da pasta do seu projeto:
python3 -m venv meu_ambiente - Ative o ambiente:
source meu_ambiente/bin/activate - Com o venv ativo (você verá o nome dele entre parênteses no início da linha), instale as dependências:
pip install -r requirements.txt - Quando terminar, é só sair do ambiente com:
deactivate
Dicas da Sensei para não ter dor de cabeça
📦 Sempre mantenha um arquivo requirements.txt atualizado com as bibliotecas do projeto — isso facilita reinstalar tudo rapidinho se precisar recriar o ambiente.
🔄 Depois de instalar ou atualizar pacotes, não esqueça de reiniciar a aplicação na tela "Configurar App Python" para as mudanças valerem.
🧩 Use sempre uma venv por projeto. Misturar bibliotecas de projetos diferentes no mesmo ambiente é a receita para bugs difíceis de rastrear.
Precisa de uma mãozinha?
Se travar em algum passo, sem crise: você conta com 30 dias de suporte gratuito após a entrega da sua hospedagem. É só acessar o painel.gehost.com.br e abrir um chamado que a equipe te ajuda a colocar seu ambiente Python de pé. 🌱
