Documentation

API and command line

Create a key in Account settings → API keys. It gives access to your bots (not your account or billing); don't share it and delete it if it leaks.

invokara command (Node.js 18 or later):

npm install -g https://invokara.fr/cli/invokara.tgz
invokara login              # paste your key
invokara bots               # your bots
invokara deploy my-bot .    # upload the folder and restart
invokara logs my-bot -f     # follow the logs

deploy replaces the files (except data/, .env and SQLite databases) without sending node_modules or .git. A version of the code is kept before each deploy (Backups tab).

GitHub Actions: add your key to the repository secrets (INVOKARA_TOKEN):

on: { push: { branches: [main] } }
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx -y https://invokara.fr/cli/invokara.tgz deploy my-bot .
        env: { INVOKARA_TOKEN: ${{ secrets.INVOKARA_TOKEN }} }

API: every request carries Authorization: Bearer ivk_… on https://invokara.fr/api: GET /bots, GET /bots/:id, POST /bots/:id/start, /stop, /restart, POST /bots/:id/upload (zip), GET /bots/:id/logs?tail=100, GET /bots/:id/stats.