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:
admin-companion-2025_public.keyfile_download

Release Notes

17 December 2025: Version 5.4-1

  • Long-term memory (managed by Admin Companion)
    Admin Companion now supports long-term memory to retain useful context across sessions. Admin Companion manages this memory automatically, and always notifies you when information is added or removed.
    View the current memory with ai -sm. Clear it at any time with ai -rm.
    Long term memory is - like the dialog history - stored on your local machine.

03 December 2025: Version 5.3-2

  • Bug fix: Error in conversation history file creation
    An error in conversation history file version management led to inability to create a new conversation history files.
    This occurred on fresh installations and when using the -c parameter. This has been fixed now.
    • Important note for upgrading existing installations

    When you already have corrupt conversation history file, please delete the file $HOME/.admin-companion/conversation_history.pickle

28 November 2025: Version 5.2-4

  • Added support for FreeBSD FreeBSD Logo
  • Improved Command Output Handling
    • Enhanced stdout/stderr interleaving
      Previous Admin Companion versions displayed all stderr output only after command execution had finished.
      Since some system commands output important prompts (e.g., password or passphrase requests) via stderr,
      these prompts could appear after user input was already expected.
      A redesigned output-shuffling algorithm now surfaces such messages earlier, ensuring user prompts appear at the correct time.
    • Commands writing directly to /dev/tty
      Output from commands executed by Admin Companion and written directly to /dev/tty is now also displayed in the terminal - even though it never goes through Admin Companion.
      This is a deliberate trade-off in our security model: Admin Companion must not have access to user keystrokes (see below).
      Capturing /dev/tty output would require attaching to it, which would also expose user keystrokes - something Admin Companion continues to avoid.
      This improvement also helps ensure correct shuffling of prompts and user input for commands executed via Admin Companion (e.g., commands that send prompts, such as password requests, directly to /dev/tty).
    • Smarter handling of long command oputput
      When command output becomes too long, it is no longer truncated at the end.
      Instead, the middle portion is collapsed, preserving the typically more relevant beginning and ending sections.
    • Continued Focus on Security and Confidentiality
      As from the beginning, your keystrokes never pass through the Admin Companion process when a command requests terminal input.
      stdin is routed directly from the system to the executed command. This ensures Admin Companion never processes your keystrokes, and no traces of typed passwords or passphrases end up in its memory - provided the command itself does not echo input to the console.
  • Improved Ctrl-C Handling (Cosmetic Update)
    Pressing Ctrl+C no longer causes the client to exit with an exception. Instead, it now terminates gracefully.

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.

Remark: You need an Admin Companion account and Admin Companion API key to use the client.

Packages for Debian based Operating Systems

Architecture Package Good for
AMD64
(for Intel and AMD) 		admin-companion_5.4-1_amd64.deb file_download Debian Debian 12 (Bookworm),  Debian 13 (Trixie)

Ubuntu Ubuntu 22.10 and later

Linux Mint Linux Mint 21 and later

Kali Linux Kali Linux 2022.4 and later

Other Linux Other Linux distributions based on Debian 12 or 13 or Ubuntu 22.10 and later
AMD64
(for Intel and AMD) 		admin-companion_5.4-1_backport_deb11_amd64.deb file_download Debian Debian 11 (Bullseye)

Ubuntu Ubuntu 20.04 - 21.10

Linux Mint Linux Mint 20.x

Kali Linux Kali Linux 2020.1 and later

Other Linux Other Linux distributions based on Debian 11 or Ubuntu 20.04 - 21.10
ARM64
(AARCH64) 		admin-companion_5.4-1_arm64.deb file_download Raspberry Pi OS Raspberry Pi OS (Based on Bookworm) on Raspi 3 and higher

Debian Debian 12 (Bookworm),  Debian 13 (Trixie)

Ubuntu Ubuntu 22.10 and later

Kali Linux Kali Linux 2022.4 - 2022.3

Other Linux Other Linux distributions based on Debian 12 or 13 or Ubuntu 22.10 and later
ARM64
(AARCH64) 		admin-companion_5.4-1_backport_deb11_arm64.deb file_download Debian Debian 11 (Bullseye)

Ubuntu Ubuntu 20.04 - 21.10

Kali Linux Kali Linux 2020.1 - 2022.3

Other Linux Other Linux distributions based on Debian 11 or Ubuntu 20.04 - 21.10

Package for RedHat / Fedora

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

Package for FreeBSD

Architecture Package Good for
AMD64
(for Intel and AMD) 		admin-companion-5.4-1_amd64.pkg file_download

Detached ASCII-armored GPG signature:
admin-companion-5.4-1_amd64.pkg.asc file_download 		FreeBSD Logo FreeBSD (tested on 14.3)

Installation procedures

Debian

Ubuntu

Linux Mint Linux Mint

Kali Linux Kali Linux

Raspberry Pi OS Raspberry Pi OS

and

Other Debian based Linux Other Debian based Linux
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_5.4-1_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_public.key
gpg --import admin-companion-2025_public.key
gpg --verify <your downloaded installation package file name>
 You get multiple lines. One line should show:
Good signature from "Admin Companion 2025 - ayonik GmbH <admin-companion@admin-companion.ai>"
...then validation is successful. You can ignore the warning message. We use a self signed signature. Just be sure, you have downloaded the public key from our website.

sudo dpkg -i <your needed package>
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-5.4-1.el8.x86_64.rpm
If you get an error message, because wget is not installed, you can install wget with:
sudo dnf 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_public.key
sudo rpm --import admin-companion-2025_public.key
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 dnf install <your needed package>
 For example: sudo dnf install admin-companion-5.4-1.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?"
FreeBSD

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-5.4-1_amd64.pkg
If you get an error message, because wget is not installed, you can install wget with:
sudo pkg install wget

If you would like to check the signature, you optionally can do so:
(You can install gpg with sudo pkg install gnupg if not yet installed)
wget https://www.admin-companion.ai/static/downloads/admin-companion-2025_public.key
wget https://www.admin-companion.ai/static/downloads/admin-companion-5.4-1_amd64.pkg.asc
gpg --import admin-companion-2025_public.key
gpg --verify admin-companion-5.4-1_amd64.pkg.asc admin-companion-5.4-1_amd64.pkg
 You get multiple lines. One line should show:
Good signature from "Admin Companion 2025 - ayonik GmbH <admin-companion@admin-companion.ai>"
...then validation is successful. You can ignore the warning message. We use a self signed signature. Just be sure, you have downloaded the public key from our website.

sudo pkg install <your needed package>
 For example: sudo pkg install admin-companion-5.4-1_amd64.pkg

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?"