wils@web ~ $ cat ~/ajuda/como-configurar-um-ambiente-virtual-python-com-venv-e-gunicorn-para-aplicacoes-web.md

Desenvolvimento

Como configurar um ambiente virtual Python com venv e Gunicorn para aplicações web

atualizado em 28/07/2026

Configurar um ambiente virtual Python é uma prática recomendada para isolar dependências de projetos. Neste guia, abordaremos como criar um ambiente virtual usando venv e configurar o Gunicorn para aplicações web.

Pré-requisitos

  • Python 3.x instalado
  • Acesso ao terminal
  • Conhecimento básico em linha de comando

Passo a Passo

1. Criar um Ambiente Virtual

Primeiro, navegue até o diretório do seu projeto e crie um ambiente virtual:

cd /caminho/do/seu/projeto
python3 -m venv venv

2. Ativar o Ambiente Virtual

Ative o ambiente virtual criado com o seguinte comando:

source venv/bin/activate

3. Instalar o Gunicorn

Com o ambiente virtual ativado, instale o Gunicorn usando o pip:

pip install gunicorn

4. Criar uma Aplicação Web Simples

Crie um arquivo chamado app.py com o seguinte conteúdo:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello, World!'

if __name__ == '__main__':
    app.run()

5. Executar a Aplicação com Gunicorn

Para iniciar a aplicação usando o Gunicorn, execute:

gunicorn -w 4 -b 0.0.0.0:8000 app:app
  • -w 4: número de workers
  • -b 0.0.0.0:8000: bind no IP e porta

Conclusão

Agora você tem um ambiente virtual Python configurado com Gunicorn para rodar sua aplicação web. Lembre-se de sempre ativar o ambiente virtual antes de instalar novas dependências e executar sua aplicação.

Dica: Utilize um arquivo requirements.txt para gerenciar suas dependências de forma eficiente.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.