177 lines
3.9 KiB
Markdown
Executable File
177 lines
3.9 KiB
Markdown
Executable File
# Deploy — Mônica no Debian 12
|
|
|
|
Este documento descreve como colocar o sistema Mônica para rodar de forma contínua em um servidor Debian 12 (Bookworm), com auto-start no boot e logs centralizados.
|
|
|
|
---
|
|
|
|
## 1. Pré-requisitos no servidor
|
|
|
|
```bash
|
|
sudo apt update
|
|
sudo apt install -y python3 python3-venv python3-pip git curl
|
|
```
|
|
|
|
Acesse o servidor como usuário comum (ex: `marco` ou `ubuntu`). NÃO execute como root a menos que saiba o que está fazendo.
|
|
|
|
---
|
|
|
|
## 2. Clonar o repositório
|
|
|
|
```bash
|
|
cd ~
|
|
git clone <URL_DO_REPOSITORIO> MonicaAgentIA
|
|
cd MonicaAgentIA/app
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Configurar o ambiente
|
|
|
|
```bash
|
|
chmod +x iniciar.sh
|
|
cp .env.example .env
|
|
nano .env # edite com suas chaves
|
|
```
|
|
|
|
Preencha obrigatoriamente:
|
|
- `TELEGRAM_BOT_TOKEN`
|
|
- `TELEGRAM_CHAT_ID`
|
|
- pelo menos uma chave de IA (`OPENROUTER_API_KEY`, `STEPFUN_API_KEY` ou `QWENCLOUD_API_KEY`)
|
|
|
|
---
|
|
|
|
## 4. Testar manualmente antes do deploy
|
|
|
|
```bash
|
|
./iniciar.sh
|
|
```
|
|
|
|
Envie uma mensagem no Telegram para o bot. Se responder, pare o processo com `CTRL+C` e prossiga.
|
|
|
|
---
|
|
|
|
## 5. Criar usuário de serviço dedicado (recomendado)
|
|
|
|
```bash
|
|
sudo useradd -r -s /bin/bash -m -d /home/monica mônica
|
|
sudo chown -R marco:marco /home/marco/MonicaAgentIA
|
|
```
|
|
|
|
Ajuste permissões:
|
|
|
|
```bash
|
|
sudo chmod 600 .env
|
|
```
|
|
|
|
---
|
|
|
|
## 6. Criar serviço systemd
|
|
|
|
Crie o arquivo `/etc/systemd/system/monica.service`:
|
|
|
|
```ini
|
|
[Unit]
|
|
Description=Mônica - Agente de IA Companheira
|
|
After=network.target
|
|
|
|
[Service]
|
|
Type=simple
|
|
User=marco
|
|
WorkingDirectory=/home/marco/MonicaAgentIA/app
|
|
Environment="PATH=/home/marco/MonicaAgentIA/app/venv/bin:/usr/bin:/bin"
|
|
ExecStart=/home/marco/MonicaAgentIA/app/venv/bin/python3 /home/marco/MonicaAgentIA/app/monica_agent.py
|
|
Restart=always
|
|
RestartSec=10
|
|
StandardOutput=journal
|
|
StandardError=journal
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
Ajuste `User` e `WorkingDirectory` conforme seu cenário.
|
|
|
|
---
|
|
|
|
## 7. Ativar e iniciar o serviço
|
|
|
|
```bash
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable monica.service
|
|
sudo systemctl start monica.service
|
|
```
|
|
|
|
Comandos úteis:
|
|
|
|
```bash
|
|
sudo systemctl status monica.service # status
|
|
sudo journalctl -u monica.service -f # logs em tempo real
|
|
sudo systemctl restart monica.service # reiniciar após alterações
|
|
```
|
|
|
|
---
|
|
|
|
## 8. Verificar se está funcionando
|
|
|
|
```bash
|
|
sudo systemctl status monica.service
|
|
```
|
|
|
|
Envie uma mensagem no Telegram para o bot. Se não houver resposta, verifique os logs:
|
|
|
|
```bash
|
|
sudo journalctl -u monica.service -n 100 --no-pager
|
|
```
|
|
|
|
### Possíveis causas se não responder
|
|
|
|
1. **Você está mandando mensagem para o bot errado** — confira o username do bot (ex: `@hermesjogo1000_bot`).
|
|
2. **Chat ID errado** — use `/debug` no bot para ver o chat ID da mensagem e compare com `TELEGRAM_CHAT_ID` no `.env`.
|
|
3. **Token inválido** — o bot pode ter sido revogado no @BotFather.
|
|
4. **Firewall bloqueando saída** — teste: `curl -s https://api.telegram.org` deve funcionar.
|
|
5. **Chave de IA ausente ou inválida** — o bot recebe a mensagem mas não consegue responder; verifique os logs.
|
|
|
|
---
|
|
|
|
## 9. Atualizações
|
|
|
|
```bash
|
|
cd /home/marco/MonicaAgentIA
|
|
git pull
|
|
cd app
|
|
source venv/bin/activate
|
|
pip install -r requirements.txt -q
|
|
sudo systemctl restart monica.service
|
|
```
|
|
|
|
---
|
|
|
|
## 10. Segurança
|
|
|
|
- Nunca comite o arquivo `.env` em repositórios públicos.
|
|
- Restrinja permissões: `chmod 600 .env`.
|
|
- Revogue tokens expostos e gere novos no @BotFather ou nos provedores de IA.
|
|
- Considere usar um `.env` fora do diretório do projeto se o servidor for compartilhado.
|
|
|
|
---
|
|
|
|
## 11. Estrutura final no servidor
|
|
|
|
```
|
|
/home/marco/MonicaAgentIA/
|
|
├── app/
|
|
│ ├── monica_agent.py
|
|
│ ├── iniciar.sh
|
|
│ ├── .env
|
|
│ ├── requirements.txt
|
|
│ ├── user_profile.json
|
|
│ ├── contexts/
|
|
│ │ └── YYYY-MM-DD.json
|
|
│ ├── README.md
|
|
│ └── LICENSE
|
|
├── venv/ # ambiente virtual local
|
|
└── .git/
|
|
```
|
|
|
|
Serviço: `/etc/systemd/system/monica.service`
|