Admin Companion - Downloads

key

All packages are signed

If you would like to check the authenticity of the packages, you can download the public key here:

Remark

Starting with version 3.2-156 we use a new public key, because the previous key was expiring.
We provide here only the new key, as old client versions are nevertheless not provided anymore. So no need for the old public key.

admin-companion-2025.pub file_download

Release Notes

19/August/2025: Version 4.0-32

  • Streaming output
    Client now supports streaming output, which allows to see the response as it is generated by the AI model.
    To do so, the client was updated to use v3.0 backend server interface, which supports streaming output.
  • Optimization in edge case handling
    We optimized the handling in cases, when commands output binary data.
  • Added Support for Debian 13 (Trixie) and Ubuntu 25.04
    With this version, we add support for Debian 13 (Trixie) and Ubuntu up to 25.04.
  • End of support for Debian 10 (Buster) and Ubuntu up to 19.10
    Debian 10 (Buster) and Ubuntu before 20.4 are no longer supported by Admin Companion.
  • New API key handling
    Due to security considerations, the API key is now removed from the system wide configuration file (/etc/admin-companion/admin-companion.cfg) and from the configuration database.
    There are three other options to store the API key now:
    • Using an environment variable ADMIN_COMPANION_KEY (user specific).
    • Using a local user file in $HOME/.admin-companion/api-key (user specific)
    • Using a dedicated, system wide credentials file /etc/admin-companion/api-key (system wide).

    See the documentation for more details about the API key handling.

    Important installation note

    If you upgrade from an old Admin Companion version, the active API key will be automatically migrated from the configuration file
    /etc/admin-companion/admin-companion.cfg
    to the new, dedicated system wide API key file
    /etc/admin-companion/api-key
    The active API key will be removed from the configuration file then. If you have additional API keys commented out in your configuration file, we recommend to move the commented ones manually to the api-key file.
    If you have a fresh installation, please make sure to set the API key in one of the three ways mentioned above, otherwise the client will not work. See the documentation for more details.

17/June/2025: Version 3.2-156

  • Fix to flush client console output early.

11/June/2025: Version 3.1-149

  • Added support for OpenAI's o4-mini model.
  • Changed the default model from o3-mini to o4-mini.
  • The -m parameter now supports selecting o3-mini, o4-mini, or gpt-4o.
  • The model used to answer each request is now always displayed.
  • Switched to new signing key: admin-companion-2025.pub

20/March/2025: Version 3.0-137

  • Now supporting OpenAI's model o3-mini
  • Added parameter -m to choose the model to be used. Default is o3-mini. gpt-4o can be chosen if needed.
  • Internal optimizations and update to the latest API structure

You can find historical release notes here.
See installation procedure further down on this page.
Remarks for version upgrade
To upgrade the client from an older version, you can use the same procedure as for a fresh installation. The client will be updated automatically.

Packages for Debian based Operating Systems

Architecture Package Good for
AMD64
(for Intel and AMD) 		admin-companion_4.0-32_amd64.deb file_download Debian Debian 13 (Trixie)

Debian Debian 12 (Bookworm)

Ubuntu Ubuntu 22.10 and later
ARM64
(AARCH64) 		admin-companion_4.0-32_arm64.deb file_download Raspberry Pi OS Raspberry Pi OS (Based on Bookworm) on Raspi 3 and higher

Debian Debian 13 (Trixie)

Debian Debian 12 (Bookworm)

Ubuntu Ubuntu 22.10 and later
AMD64
(for Intel and AMD) 		admin-companion_4.0-32_backport_deb11_amd64.deb file_download Debian Debian 11 (Bullseye)

Ubuntu Ubuntu 20.04 - 21.10
ARM64
(AARCH64) 		admin-companion_4.0-32_backport_deb11_arm64.deb file_download Raspberry Pi OS Raspberry Pi OS (Based on Bullseye) on Raspi 3 and higher

Debian Debian 11 (Bullseye)

Ubuntu Ubuntu 20.04 - 21.10

Package for RedHat / Fedora

Architecture Package Good for
AMD64
(for Intel and AMD) 		admin-companion-4.0-32.el8.x86_64.rpm file_download RedHat RHEL 8 and higher
Fedora Fedora Versions 37 and higher

Installation procedures

Debian

Ubuntu

and

Raspberry Pi OS Raspberry Pi OS

Search your needed download package in the table above and download it to your machine:
wget https://www.admin-companion.ai/static/downloads/<your needed package>
 For example: wget https://www.admin-companion.ai/static/downloads/admin-companion_4.0-32_amd64.deb
If you would like to check the signature, you optionally can do so:
wget https://www.admin-companion.ai/static/downloads/admin-companion-2025.pub
gpg --import admin-companion-2025.pub
gpg --verify <your downloaded installation package file name>
 If you get one line starting with:
gpg: Good signature from "ayonik GmbH <info@ayonik.de>"
 then validation is successful. You can ignore the warning message about certification.

sudo dpkg -i <your needed package>

 You can confirm the question about the symlink in the configuration procedure by pressing <Enter>, if you do not have a command called "ai" on your system. If you do not use the command name "ai" for another application. If "ai" is already used, we recommend to choose another shortcut name.

For fresh installations (if you don't upgrade an existing version):
  • Request an API key on the API keys page from the Admin Companion web console (you need to log in to access the page).
  • Create the file
    $HOME/.admin-companion/api-key (Do not forget the dot "." in the path name)
    with this content
    ADMIN_COMPANION_KEY="<Your API key>"
  • Make sure, your system can reach https://api.admin-companion.ai:443
To test Admin Companion, call Admin Companion from within your shell:
ai "Are you there?"
RedHat

and

Fedora
Search your needed download package in the table above and download it to your machine:
wget https://www.admin-companion.ai/static/downloads/<your needed package>
 For example: wget https://www.admin-companion.ai/static/downloads/admin-companion-4.0-32.el8.x86_64.rpm
If you get an error message, because wget is not installed, you can install wget with:
sudo yum install wget

If you would like to check the signature, you optionally can do so:
wget https://www.admin-companion.ai/static/downloads/admin-companion-2025.pub
sudo rpm --import admin-companion-2025.pub
rpm -K <your downloaded installation package file name>
 You should get this:
<your downloaded installation package file name>: digests signatures OK
then validation is successful.
If you don't see the digests or you don't see the signatures --> Then something is wrong.

sudo yum install <your needed package>
 For example: sudo yum install admin-companion-4.0-32.el8.x86_64.rpm

For fresh installations (if you don't upgrade an existing version):
  • Request an API key on the API keys page from the Admin Companion web console (you need to log in to access the page).
  • Create the file
    $HOME/.admin-companion/api-key (Do not forget the dot "." in the path name)
    with this content
    ADMIN_COMPANION_KEY="<Your API key>"
  • Make sure, your system can reach https://api.admin-companion.ai:443
To test Admin Companion, call Admin Companion from within your shell:
ai "Are you there?"
SuSE
Will follow