Skip to content

Latest commit

 

History

History
174 lines (135 loc) · 3.79 KB

subiropenwebui.md

File metadata and controls

174 lines (135 loc) · 3.79 KB

Aqui está um passo-a-passo atualizado e detalhado para configurar o pyenv corretamente e garantir que o OpenWebUI funcione sem problemas:


1. Verificar e Reinstalar o pyenv

  1. Remova qualquer instalação antiga do pyenv:

    rm -rf ~/.pyenv
  2. Instale o pyenv novamente usando o script oficial:

    curl https://pyenv.run | bash
  3. Adicione o pyenv ao ambiente atual do shell: Edite o arquivo de configuração do shell (~/.bashrc ou ~/.zshrc):

    nano ~/.bashrc

    Adicione estas linhas ao final do arquivo:

    export PATH="$HOME/.pyenv/bin:$PATH"
    eval "$(pyenv init --path)"
    eval "$(pyenv init -)"

    Recarregue o shell:

    source ~/.bashrc
  4. Verifique a instalação do pyenv:

    pyenv --version

    Isso deve retornar algo como pyenv 2.x.x.


2. Instalar e Configurar a Versão do Python

  1. Liste as versões disponíveis do Python:

    pyenv install --list
  2. Instale a versão necessária (ex: Python 3.11.0):

    pyenv install 3.11.0
  3. Defina a versão do Python para o projeto (ou globalmente):

    • Para o ambiente global:
      pyenv global 3.11.0
    • Para o diretório do OpenWebUI: Navegue até o diretório do OpenWebUI:
      cd /path/to/openwebui
      Defina a versão local:
      pyenv local 3.11.0
  4. Verifique a versão ativa do Python:

    python --version

    O retorno deve ser Python 3.11.0.


3. Instalar e Configurar o OpenWebUI

  1. Clonar o repositório:

    git clone https://github.com/Open-WebUI/open-webui.git
    cd open-webui
  2. Criar um ambiente virtual:

    python -m venv venv
    source venv/bin/activate
  3. Instalar dependências:

    pip install --upgrade pip
    pip install -r requirements.txt
  4. Iniciar o OpenWebUI:

    open-webui serve

    Se precisar rodar com sudo, configure o ambiente corretamente:

    sudo env "PATH=$PATH" open-webui serve

4. Verificar o Funcionamento

  • Acesse o OpenWebUI pelo navegador em:

    http://localhost:8080
    
  • Se a porta 8080 já estiver ocupada, use outra porta:

    PORT=8000 open-webui serve

5. Configuração Automática com systemd (Opcional)

  1. Crie um arquivo de serviço:

    sudo nano /etc/systemd/system/open-webui.service
  2. Adicione esta configuração:

    [Unit]
    Description=OpenWebUI Service
    After=network.target
    
    [Service]
    User=your-username
    Group=your-group
    WorkingDirectory=/path/to/open-webui
    ExecStart=/path/to/open-webui/venv/bin/open-webui serve
    Restart=always
    
    [Install]
    WantedBy=multi-user.target

    Substitua your-username, your-group e /path/to/open-webui com as informações reais do seu sistema.

  3. Ativar e iniciar o serviço:

    sudo systemctl daemon-reload
    sudo systemctl enable open-webui
    sudo systemctl start open-webui
  4. Verifique o status do serviço:

    sudo systemctl status open-webui

6. Solução de Problemas

  • Erro: command not found para open-webui: Certifique-se de que o ambiente virtual está ativado e que o comando foi instalado com o pip.

  • Erro: sudo export não funciona: Use o comando sudo env para passar as variáveis de ambiente.

  • Erro: Permissões ou dependências faltando: Sempre execute os comandos no ambiente virtual ou confira se o pyenv está configurado corretamente.

Pronto! Agora o OpenWebUI deve estar configurado e rodando sem problemas. 🚀