Instalação

O sistema Hypatia pode ser instalado de forma simples tanto em ambientes locais (para testes e desenvolvimento) quanto em servidores de produção com suporte a Gunicorn + Nginx, ideal para implantações públicas ou institucionais.

A seguir, descrevemos os dois modos de instalação disponíveis.

Instalação Manual (modo local)

Este método é recomendado para testes, desenvolvimento ou uso em máquinas pessoais. O sistema é executado diretamente com o servidor de desenvolvimento do Flask.

1. Clonando o repositório

git clone git@github.com:LeoVichi/hypatia.git
cd hypatia

2. Criando um ambiente virtual Python

python3 -m venv venv
source venv/bin/activate        # No Windows: venv\Scripts\activate

3. Instalando as dependências

pip install -r requirements.txt

4. Executando a aplicação

python app.py

O sistema estará acessível via navegador em:

🌐 http://localhost:5000

Instalação Automática (Deploy com Nginx + Gunicorn)

Para ambientes de produção (como VPS Ubuntu), a instalação pode ser automatizada com o script setup_nginx.sh, que prepara o servidor com os serviços necessários.

  1. Executar o script de configuração
    ./setup_nginx.sh

    Esse script configura automaticamente:

    • Um ambiente virtual isolado

    • Gunicorn como servidor WSGI

    • Um serviço systemd para manter o app ativo

    • Nginx como proxy reverso apontando para o Gunicorn

    • Permissões e pastas básicas do sistema

  2. Reiniciar o serviço Nginx
    sudo systemctl restart nginx

Após a execução, a aplicação estará disponível no domínio configurado, geralmente em:

🌐 http://seu-servidor.com ou http://localhost (internamente)

Requisitos do sistema