Files

T

marco e489b6a2e2 feat: initial project setup with psagentia agent implementation

Add core Python agent with configuration management, environment setup,
and deployment documentation. Includes user/agent profiles, startup
scripts, and dependency management for the psagentia system.

2026-09-03 16:11:46 -03:00

3.9 KiB

Executable File

Raw Blame History

Deploy — PsAgentIA no Debian 12

Este documento descreve como colocar o sistema PsAgentIA 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

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

cd ~
git clone <URL_DO_REPOSITORIO> PsAgentIA
cd PsAgentIA/app

3. Configurar o ambiente

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

./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)

sudo useradd -r -s /bin/bash -m -d /home/psagentia psagentia
sudo chown -R marco:marco /home/marco/PsAgentIA

Ajuste permissões:

sudo chmod 600 .env

6. Criar serviço systemd

Crie o arquivo /etc/systemd/system/psagentia.service:

[Unit]
Description=PsAgentIA - Personal Agent IA Conversacional
After=network.target

[Service]
Type=simple
User=marco
WorkingDirectory=/opt/PsAgentIAMarco/app
Environment="PATH=/opt/PsAgentIAMarco/app/venv/bin:/usr/bin:/bin"
ExecStart=/opt/PsAgentIAMarco/app/venv/bin/python3 /opt/PsAgentIAMarco/app/psagentia_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

sudo systemctl daemon-reload
sudo systemctl enable psagentiamarco.service
sudo systemctl start psagentiamarco.service

Comandos úteis:

sudo systemctl status psagentia.service   # status
sudo journalctl -u psagentia.service -f   # logs em tempo real
sudo systemctl restart psagentia.service  # reiniciar após alterações

8. Verificar se está funcionando

sudo systemctl status psagentia.service

Envie uma mensagem no Telegram para o bot. Se não houver resposta, verifique os logs:

sudo journalctl -u psagentia.service -n 100 --no-pager

Possíveis causas se não responder

Você está mandando mensagem para o bot errado — confira o username do bot (ex: @hermesjogo1000_bot).
Chat ID errado — use /debug no bot para ver o chat ID da mensagem e compare com TELEGRAM_CHAT_ID no .env.
Token inválido — o bot pode ter sido revogado no @BotFather.
Firewall bloqueando saída — teste: curl -s https://api.telegram.org deve funcionar.
Chave de IA ausente ou inválida — o bot recebe a mensagem mas não consegue responder; verifique os logs.

9. Atualizações

cd /home/marco/PsAgentIA
git pull
cd app
source venv/bin/activate
pip install -r requirements.txt -q
sudo systemctl restart psagentia.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/PsAgentIA/
├── app/
│   ├── psagentia_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/psagentia.service

3.9 KiB Executable File Raw Blame History