Aqui está um passo-a-passo atualizado e detalhado para configurar o pyenv corretamente e garantir que o OpenWebUI funcione sem problemas:
-
Remova qualquer instalação antiga do
pyenv
:rm -rf ~/.pyenv
-
Instale o
pyenv
novamente usando o script oficial:curl https://pyenv.run | bash
-
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
-
Verifique a instalação do
pyenv
:pyenv --version
Isso deve retornar algo como
pyenv 2.x.x
.
-
Liste as versões disponíveis do Python:
pyenv install --list
-
Instale a versão necessária (ex: Python 3.11.0):
pyenv install 3.11.0
-
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:
Defina a versão local:
cd /path/to/openwebui
pyenv local 3.11.0
- Para o ambiente global:
-
Verifique a versão ativa do Python:
python --version
O retorno deve ser
Python 3.11.0
.
-
Clonar o repositório:
git clone https://github.com/Open-WebUI/open-webui.git cd open-webui
-
Criar um ambiente virtual:
python -m venv venv source venv/bin/activate
-
Instalar dependências:
pip install --upgrade pip pip install -r requirements.txt
-
Iniciar o OpenWebUI:
open-webui serve
Se precisar rodar com
sudo
, configure o ambiente corretamente:sudo env "PATH=$PATH" open-webui serve
-
Acesse o OpenWebUI pelo navegador em:
http://localhost:8080
-
Se a porta 8080 já estiver ocupada, use outra porta:
PORT=8000 open-webui serve
-
Crie um arquivo de serviço:
sudo nano /etc/systemd/system/open-webui.service
-
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. -
Ativar e iniciar o serviço:
sudo systemctl daemon-reload sudo systemctl enable open-webui sudo systemctl start open-webui
-
Verifique o status do serviço:
sudo systemctl status open-webui
-
Erro:
command not found
paraopen-webui
: Certifique-se de que o ambiente virtual está ativado e que o comando foi instalado com opip
. -
Erro:
sudo export
não funciona: Use o comandosudo 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. 🚀