EN·ES·DE·PT·FR
⌘K

Instalação como Serviço

Instale o aidaemon como um serviço do sistema que inicia na inicialização e roda indefinidamente.

Comando de Instalação

bash
./aidaemon install-service

Isso detecta automaticamente a plataforma e gera a configuração de serviço apropriada.

Linux (systemd)

Cria /etc/systemd/system/aidaemon.service:

aidaemon.service
[Unit]
Description=aidaemon AI Agent
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/full/path/to/aidaemon
WorkingDirectory=/path/to/config/dir
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Depois habilita e inicia o serviço:

bash
sudo systemctl daemon-reload
sudo systemctl enable --now aidaemon

macOS (launchd)

Cria $HOME/Library/LaunchAgents/ai.aidaemon.plist:

ai.aidaemon.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>ai.aidaemon</string>
    <key>ProgramArguments</key>
    <array>
        <string>/full/path/to/aidaemon</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/aidaemon.stdout.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/aidaemon.stderr.log</string>
</dict>
</plist>

Depois carrega o serviço:

bash
launchctl load ~/Library/LaunchAgents/ai.aidaemon.plist
Prevenir Suspensão do macOS
O macOS pode suspender processos em segundo plano quando o sistema entra em suspensão. Para manter o aidaemon rodando continuamente, use caffeinate:

caffeinate -s aidaemon

A flag -s impede a suspensão enquanto o processo está rodando. Você também pode usar caffeinate -i para impedir a suspensão por inatividade sem manter a tela ligada. Se estiver rodando como serviço launchd, adicione caffeinate -s antes do caminho do binário nos ProgramArguments do seu plist.

Verificação de Saúde

Uma vez rodando como serviço, verifique com:

bash
curl http://127.0.0.1:8080/health
# {"status": "ok"}

O endpoint de saúde é servido pelo axum no daemon.health_bind:daemon.health_port configurado.

AnteriorGerenciamento de Estado & MemóriaPróximoSistema de Eventos