IA Olympus. Installer Downloads Create account
Publication note: screenshots from the previous release were removed during the rebrand. The steps, requirements and links remain valid.
Linux x64 · version 1.0.5

From zero to your first IA Olympus agent

A visual guide to installing and connecting a coding assistant without using the terminal, hunting for paths or learning technical settings. If you can download a file and paste a key, you can complete this tutorial.

  • 15–20 minutes the first time
  • Interface in Spanish and English
  • Your key is stored securely
Real application · Linux x64

Before you touch anything

What is this and what will it do for you?

An agent is an assistant that works with the files in a project. You describe what you want in plain language and it reviews files, suggests changes or carries out tasks. IA Olympus Agent Installer prepares that assistant and connects it to your IA Olympus account.

It installs the tool

It downloads the agent from its official source and places it in a private folder in your user area. You do not need to know where it is or type any paths.

It connects your account

You enter your IA Olympus key once. The app verifies that it works and prepares the agent to use your account.

It checks and opens

At the end, you see what is installed, what is configured and whether the connection was validated. Then you can open the agent from the app itself.

This is not a website or a server. It is a desktop application. All the work happens on your computer and in your user folder. The app sends no telemetry and collects no conversations.

Checklist

What you need before you start

You do not need to prepare anything else. The app checks these points and tells you exactly what is missing if something does not meet the requirements.

  • A 64-bit Linux computer (x64).
  • An Internet connection to download the agent and validate your account.
  • A IA Olympus account with an active key.
  • At least 1 GB of free space; some agents ask for 80–250 MB.
  • Node.js only if the agent you choose requires it. The app never installs or updates it on its own.
  • Administrator permission only where the app explains why; most agents do not need it.
Important: if Node.js is already installed, the app does not reinstall or remove it. It only checks its version. If the version is too old, it blocks the affected agent and offers an official page plus a fresh check.

Choose your format

Download the installer

Both options install the same application. Choose AppImage for a portable file, or DEB if your distribution prefers system installers. You do not need Node.js to open this application.

DEB package

iaolympus-agent-installer_amd64.deb

For Debian, Ubuntu and compatible distributions. It opens in the software centre and is added to the application menu.

  • Version1.0.5
  • Size≈ 97 MB
  • Architectureamd64
  • SignatureUnsigned
Download DEB
This build is not digitally signed. Your system may therefore show a warning. Do not disable the firewall or system protections. You can check the SHA-256 fingerprint below, or use the troubleshooting section if the file does not open.
How to open the AppImage if double-clicking does nothing

Right-click the file, open Properties → Permissions and enable Allow executing file as program. Then double-click it again.

If your distribution still does not open it, use the DEB package. It is the simpler alternative and requires no commands.

How to install the DEB from the software centre

Double-click the downloaded file. Your distribution's software centre opens; click Install and confirm. When it finishes, search for IA Olympus Agent Installer in the application menu.

If your system does not offer that option, ask for help before using the terminal. Do not copy commands from unknown websites.

Complete visual tutorial

From the first click to your first agent

These are real screenshots of the application on Linux. The pointer and yellow label mark the element being described. Click any image to see it at full size.

Open the application

After installing the AppImage or DEB, open IA Olympus Agent Installer. The first time, a welcome screen explains the whole process in four ideas: choose, install, connect and check.

  1. Read the summary at your own pace.
  2. If you want to visit the official site, click iaolympus.com.
  3. Click Get started.
Nothing is installed yet. The welcome screen only introduces the assistant and explains what will happen.

Choose the language

At the top right there are two separate buttons: Español and English. The highlighted button shows the active language. The app detects your system language on first launch, but you can change it at any time.

  1. Click English to switch the whole interface to English.
  2. Click Español to return to Spanish.
  3. Your choice is remembered the next time you open the app.
This guide is available in both languages. The English screenshots show the application genuinely running in English, not an overlay translation.

Choose an agent

The left column lists the eight catalog agents. Each row has an icon, a short explanation and a status. The search box finds agents by name or function; the Status menu filters the list. This computer: Linux reminds you which system you are using.

  1. To begin, select Codex.
  2. If an agent is already installed, it is marked and will not be duplicated.
  3. You can switch agents at any time without losing the other configurations.
What the statuses mean: Available, Requires Node.js, Requires WSL2, Requires guided installation, Already installed, Not available and Requires administrator permission. Only the affected agent is blocked.

Read the details and click Install

The right panel is written so that you do not need technical knowledge. It explains what the agent is for, what you can do with it, which permissions it asks for, how long it takes and how much space it needs. It also says whether it uses IA Olympus balance.

  1. Review the difficulty, time and space cards.
  2. Check that the status says Available.
  3. Click Install when you are ready.
The model check does not consume tokens. The agent's conversations and tasks do use IA Olympus balance.

Review before confirming

Before touching your computer, the app shows a summary: which agent will be installed, in which private folder, which configuration file will be prepared and which method will be used. Agents that do not need administrator access will not ask for your system password.

  1. Read the summary and check that the agent is the right one.
  2. If elevated permission is required, the app shows the exact command and asks for explicit consent.
  3. Click Install now to begin.
Remote scripts are never run blindly. No curl|bash pipe is used without showing the command, explaining the risk and asking for permission first.

Wait while it downloads

The bar at the bottom shows the current phase and a percentage. It may take a few minutes depending on your connection. Do not close the window or turn off the computer during this step.

  1. Wait until the percentage finishes and the bar disappears.
  2. If there is an error, the app explains it clearly and lets you retry.
  3. If there is no Internet, you will see a specific message; try again when the connection returns.
The app does not claim success just because a file was downloaded. It only reports the agent as installed after the later check confirms it.

Paste your IA Olympus key

When installation finishes, the Connect your IA Olympus account dialog appears. The key looks like sk-iaolympus-…. Use Paste instead of typing it by hand. You can use Show and Hide to check that it is complete.

  1. Paste the key and remove any accidental leading or trailing spaces.
  2. Use Show/Hide only if you need to check it.
  3. Click Validate and save.
The key is never passed as a visible argument. It uses the system's secure store; on Linux, if no keyring is available, protected local encryption is used and the app tells you.

Validate the account and models

When you save, the app checks that the key is valid and that your account can use IA Olympus's public models. This is what separates a working key from one that is mistyped, expired or revoked.

  1. If the key is not valid, you will see a clear error without the key being displayed.
  2. If it is valid, the app configures the agent to use IA Olympus automatically.
  3. The key is not written to logs or application reports.
IA Olympus's API does not store your conversations. Each client sends its own history. The app collects neither prompts nor responses.

All set: open your agent

The final screen separates three things that are not the same: installed, configured and connection validated. If all three are green, the tool is ready to use. Click Open agent.

  1. Check that Installed, Configured and Connection validated all say yes.
  2. Click Open agent. If it opens in a terminal, the key is loaded for that session only.
  3. If you prefer to open it later, click Close and use the IA Olympus shortcut in the application menu.
Honest certification: a validated connection is not the same as a full conversational test of every agent feature. The app reports both states separately.

Come back whenever you need

Next time you open the assistant, the agent appears as Already installed. From its panel you can reconfigure, repair, test the connection or uninstall it. There is no need to install a second copy.

  1. Reconfigure: reconnect the account or change settings without installing another copy.
  2. Repair: rebuild anything missing while preserving other configuration.
  3. Test connection: check the account and models without starting a conversation.
  4. Uninstall: remove the program installed by this app and its IA Olympus configuration, keeping a backup before changing files.
Your key is managed separately. To remove it from the computer as well, use Key stored in the header and choose the removal option.

Qoder: not available in this version

Qoder is listed so you know it exists, but it is disabled. Its current assistant does not allow a custom base URL. The app therefore neither installs it nor advertises it as compatible: doing so another way would be unsafe and could break your account.

  1. You will not see an active install button.
  2. The panel explains the reason in plain language.
  3. You can visit the official website without the app changing anything.
This is not your fault or a problem with your computer. It is a real limitation of the product in this version, shown transparently.

WorkBuddy / CodeBuddy: guided installation

This agent has no reliable silent installer. Instead of pretending to install it automatically, the app opens the official download and walks you through the steps. Once the tool is detected, the app prepares its local model file for IA Olympus.

  1. Click Open guided installation and follow the official page.
  2. Return to the app and click Check again.
  3. The app only reports it as installed when it detects it for real.
Certification status: guided and pending certification. It is not presented as a silent installation that does not exist.

Read the screen

What each status means

If a requirement is missing, the app blocks only the affected agent. The others remain available. Node.js is never installed and elevated access is never requested silently.

StatusWhat it meansWhat you can do
AvailableThe agent can be installed and no known requirement is missing.Click Install and review the summary.
Requires Node.jsNode.js is missing or the installed version is below the agent's minimum.Open the official Node.js page and Check again. The app does not install or update it by itself.
Requires WSL2The agent needs WSL2 on Windows. This does not apply on Linux.Read the explanation, open the official guide and check again.
Requires guided installationThere is no reliable silent installer.Open the official download, follow the steps and check again.
Already installedThe app detected an existing installation.Reconfigure, repair, test the connection or uninstall. It is not duplicated.
Not availableThe agent cannot be used safely in this version.Read the reason and do not force an unsafe configuration.
Requires administrator permissionInstallation needs a specific elevation.Review the exact command and give consent before it runs.

After installation

Maintain, repair or start over

You do not need to install the assistant again to change your mind. Open the same application and work with the agent already shown in the list.

Reconfigure

Reconnect the account or change settings without duplicating files or configuration blocks.

Repair

Rebuild what is missing while preserving what already belongs to you. A backup is kept before modifying a file.

Test connection

Check that IA Olympus responds and both public models are available. It starts no conversation and consumes no model tokens.

Uninstall

Remove the program installed by this app and its IA Olympus configuration. The key is removed separately from Key stored.

Open agent

Launch the agent with the connection already prepared. If it does not open, review the final-screen instructions and troubleshooting.

Check again

Detect dependencies and statuses again after installing Node.js, WSL2 or a guided tool.

Privacy and control

Your key, your files, your decisions

The application is designed to ask for as little as possible and explain what it does. These are the guarantees you can check in the interface and in the project documentation.

The key is not shown in logs

No keys, authorization headers, cookies or complete service responses are written to visible logs.

System secure storage

The keyring is used when available. If there is none, local encryption with restricted permissions is used and the app clearly warns you.

No telemetry

The app sends no usage data, prompts, responses or project information. Conversations belong to your agent and to you.

Node.js is left alone

It never installs, updates, reinstalls or uninstalls Node.js. It only checks the real version with semver and blocks the affected agent if needed.

Permissions explained

It does not request administrator access until necessary. If needed, it shows the command and asks for explicit consent before running it.

IA Olympus only

Generated configurations point only to IA Olympus and reference the key instead of placing literal keys in files that could end up in Git.

If something does not go as expected

Solutions to common problems

Start with the simplest solution. Do not disable the firewall, antivirus or system protections just to make an installation work.

I have no Internet, or the app says it cannot connect

Check that your browser can open a page. When the connection returns, click Check again or close and reopen the app. Installation is not reported complete if only part of a download succeeded.

My key is not valid

Check that it starts with sk-iaolympus- and that you have not pasted leading or trailing spaces. Use Show to confirm it is complete, then click Validate and save again. If it still fails, check in your account that the key is active and has not been revoked.

Never send your key through chat, email or a screenshot.

Node.js is missing or too old

Only the agent that needs Node.js is blocked. Click Open official Node.js page, install a compatible version and return to the app to click Check again. The application does not change your existing installation.

There is not enough space

The app measures real free space and keeps a 512 MB safety margin. If there is not enough, it blocks installation rather than risking a full disk. Free some space and check again; some agents use 80–250 MB.

The AppImage does not open when I double-click it

Enable execution permission in Properties → Permissions. If your distribution does not allow that, use the DEB package. Do not run the file as administrator just to bypass the warning.

I installed the agent, but I cannot find the shortcut

Search for IA Olympus in the application menu. The app creates a shortcut in your user folder when the agent supports it. If it does not appear, return to the assistant, open the agent's panel and use Repair or Open agent.

The installation failed halfway through

Read the app's message: it distinguishes between network, permission, dependency and installer errors. Try again from the agent panel. Do not delete files by hand or copy configurations from older versions.

Qoder will not let me install it

That is intentional. In this version, its assistant does not allow a custom base URL. Installing or configuring it another way would be unsafe. The app shows this transparently and does not modify your computer.

Frequently asked questions

What a first-time user usually asks

Do I need to know how to code to use this application?

No. The installer is designed so you can choose an agent, paste a key and open it. The agent will help you work with code, but you can start by asking it for explanations in plain language.

Does the application store my conversations?

No. The application collects no prompts, responses or project data. IA Olympus's API does not store conversations either: each client sends its own history.

What is the difference between installed, configured and connection validated?

Installed means the program is present. Configured means its settings point to IA Olympus. Connection validated means the account and models responded correctly. A full conversational test is reported separately.

Can it be used without a system keyring?

Yes. The app warns you and uses the safest possible local fallback with restricted permissions. Even so, protect your computer with a user account and password.

Can I change the language later?

Yes. The Español and English buttons in the header switch the whole interface and are remembered for the next launch.

Why are some agents marked as pending?

Because a complete installation or conversation has not been demonstrated in that environment. The app prefers to say so honestly rather than claim something works when only a configuration file was written.

Advanced download verification

If you want to make sure the file was not modified during download, compare its SHA-256 fingerprint with the published one. This is optional for normal use and is not required to install.

AppImage · 100,777,298 bytes

aa1da26cb45965bf2ab0a8f8d8ab1e53970b08b9ed9545bc684ed8d775ea91ec

DEB · 100,871,824 bytes

c1a53f39cd7279b570f4128a840d49722e79e5943b09732769d6947134f425aa