ThorAgentIA/DEPLOY_VPS.md

Deploy em VPS - ThorAgentIA

Guia completo para rodar o ThorAgentIA automaticamente em um servidor VPS Linux (Debian/Ubuntu).

---

Pré-requisitos

• Acesso SSH ao servidor VPS
• Python 3.10+ instalado
• Git (opcional, para clonar o repositório)
• Sudo/root configurado

---

Passo 1: Preparar o Servidor

# Atualizar pacotes
sudo apt update && sudo apt upgrade -y

# Instalar dependências básicas
sudo apt install -y python3 python3-venv python3-pip git curl

# Verificar versão do Python
python3 --version

---

Passo 2: Transferir o Projeto para o VPS

Opção A: Via Git (recomendado)

# Clonar o repositório
git clone <URL_DO_REPOSITORIO> /opt/thoragentia
cd /opt/thoragentia/app

Opção B: Via SCP/SFTP

# No seu computador local
scp -r app/ usuario@vps:/opt/thoragentia/

Opção C: Via rsync

rsync -avz app/ usuario@vps:/opt/thoragentia/app/

---

Passo 3: Configurar o Ambiente

cd /opt/thoragentia/app

# Dar permissão de execução ao script
chmod +x iniciar.sh

# Executar o script de inicialização
./iniciar.sh

O script irá:

• Criar o ambiente virtual
• Instalar dependências
• Preparar o sistema

---

Passo 4: Configurar Variáveis de Ambiente

# Criar/editar o arquivo .env
nano /opt/thoragentia/app/.env

Preencher com:

TELEGRAM_BOT_TOKEN=seu_token
TELEGRAM_CHAT_ID=seu_chat_id
INTERVAL_MINUTES=60
START_HOUR=7
END_HOUR=22
DAYS_OF_WEEK=1,2,3,4,5,6,7
TOPICS=Marketing,Negócios,Produtividade,Liderança,Vendas

OPENROUTER_API_KEY=sua_chave_openrouter
OPENROUTER_MODEL=seu_modelo

---

Método 1: systemd (Recomendado para Produção)

4.1 Criar o arquivo de serviço

sudo nano /etc/systemd/system/thoragentia.service

Conteúdo:

[Unit]
Description=ThorAgentIA - Sistema de Insights via Telegram
After=network.target

[Service]
Type=simple
User=marco
Group=seu_usuario
WorkingDirectory=/opt/thoragentia/app
ExecStart=/opt/thoragentia/app/venv/bin/python3 /opt/thoragentia/app/main.py
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=thoragentia

# Segurança (opcional mas recomendado)
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Importante: Substitua seu_usuario pelo usuário real do sistema (não use root).

4.2 Habilitar e iniciar o serviço

# Recarregar configurações do systemd
sudo systemctl daemon-reload

# Habilitar inicialização automática no boot
sudo systemctl enable thoragentia.service

# Iniciar o serviço
sudo systemctl start thoragentia.service

4.3 Comandos de gerenciamento

# Verificar status do serviço
sudo systemctl status thoragentia.service

# Parar o serviço
sudo systemctl stop thoragentia.service

# Reiniciar o serviço
sudo systemctl restart thoragentia.service

# Ver logs em tempo real
sudo journalctl -u thoragentia.service -f

# Ver últimas 100 linhas de log
sudo journalctl -u thoragentia.service -n 100

# Desabilitar inicialização automática
sudo systemctl disable thoragentia.service

4.4 Verificar se está rodando

ps aux | grep main.py | grep -v grep

---

Método 2: screen/tmux (Alternativa Simples)

Usando screen

# Instalar screen (se não tiver)
sudo apt install -y screen

# Criar uma nova sessão
screen -S thoragentia

# Dentro da sessão, executar:
cd /opt/thoragentia/app
source venv/bin/activate
python3 main.py

# Desanexar da sessão: Ctrl+A, depois D

# Para retomar a sessão:
screen -r thoragentia

# Para encerrar a sessão:
# Dentro da sessão: Ctrl+C, depois digite "exit"

Usando tmux

# Instalar tmux
sudo apt install -y tmux

# Criar nova sessão
tmux new -s thoragentia

# Executar:
cd /opt/thoragentia/app
source venv/bin/activate
python3 main.py

# Desanexar: Ctrl+B, depois D

# Retomar sessão:
tmux attach -t thoragentia

# Encerrar sessão:
# Dentro da sessão: Ctrl+C, depois digite "exit"

---

Método 3: nohup (Execução Simples em Background)

cd /opt/thoragentia/app
source venv/bin/activate

# Executar em background com logs
nohup python3 main.py > thoragentia.log 2>&1 &

# Verificar PID
ps aux | grep main.py | grep -v grep

# Parar o processo (substitua PID pelo número real)
kill PID

# Ou matar todos os processos main.py
pkill -f "python3 main.py"

---

Logs e Monitoramento

Logs do systemd

# Ver logs do serviço
sudo journalctl -u thoragentia.service --since "1 hour ago"

# Ver apenas erros
sudo journalctl -u thoragentia.service -p err

# Limpar logs antigos
sudo journalctl --vacuum-time=7d

Logs da aplicação (se usar nohup)

# Ver logs em tempo real
tail -f thoragentia.log

# Ver últimas 50 linhas
tail -n 50 thoragentia.log

---

Atualizações do Sistema

cd /opt/thoragentia/app

# Parar o serviço (se usar systemd)
sudo systemctl stop thoragentia.service

# Atualizar código (se usar git)
git pull origin main

# Reinstalar dependências (se necessário)
source venv/bin/activate
pip install -r requirements.txt --upgrade

# Reiniciar o serviço
sudo systemctl start thoragentia.service

---

Segurança

• Nunca comite o arquivo .env com dados reais
• Use permissões restritivas no .env:

  chmod 600 /opt/thoragentia/app/.env
  

• Configure firewall para restringir acesso SSH
• Mantenha o sistema atualizado: sudo apt update && sudo apt upgrade -y
• Use chaves SSH para acesso ao VPS (desative senha)

---

Solução de Problemas

Serviço não inicia

# Verificar logs
sudo journalctl -u thoragentia.service -n 50

# Testar execução manual
cd /opt/thoragentia/app
source venv/bin/activate
python3 main.py

Erro de permissão

# Ajustar permissões do diretório
sudo chown -R seu_usuario:seu_usuario /opt/thoragentia
chmod +x /opt/thoragentia/app/iniciar.sh
chmod 600 /opt/thoragentia/app/.env

Variáveis de ambiente não carregam

# Verificar se o .env está no diretório correto
ls -la /opt/thoragentia/app/.env

# Testar leitura do .env
cd /opt/thoragentia/app
python3 -c "from dotenv import load_dotenv; import os; load_dotenv(); print(os.getenv('TELEGRAM_BOT_TOKEN'))"

---

Backup

# Fazer backup do .env
cp /opt/thoragentia/app/.env /home/seu_usuario/backup-thoragentia-$(date +%Y%m%d).env

# Backup completo do projeto
tar -czf thoragentia-backup-$(date +%Y%m%d).tar.gz /opt/thoragentia/

---

Comandos Rápidos de Referência

Ação	Comando (systemd)	Comando (screen/tmux)	Comando (nohup)
Iniciar	sudo systemctl start thoragentia	screen -r thoragentia + python3 main.py	nohup python3 main.py &
Parar	sudo systemctl stop thoragentia	Ctrl+C dentro da sessão	pkill -f main.py
Status	sudo systemctl status thoragentia	screen -ls / tmux ls	ps aux | grep main.py
Logs	sudo journalctl -u thoragentia -f	Ver tela da sessão	tail -f thoragentia.log
Reiniciar	sudo systemctl restart thoragentia	Parar e iniciar novamente	pkill -f main.py + nohup ...

---

Contato

Para suporte: marcocosta@gmx.com