Skip to content

Installation

  1. Download the installer:

    https://contextcodedev.iaforged.com/downloads/ContextCode-Setup.exe
  2. Run ContextCode-Setup.exe and follow the wizard (it is a standard NSIS installer: next, next, install).

  3. When it finishes, open Context Code from the Start menu. You will see the splash screen with the logo and the tagline “Create without limits”.

The Windows installer: a few clicks and you are done.
  1. Download the disk image:

    https://contextcodedev.iaforged.com/downloads/ContextCode.dmg
  2. Open it with a double click and drag Context Code into the Applications folder.

  3. Open the app from Launchpad or from Applications.

Requires macOS 13 (Ventura) or later on a Mac with Apple Silicon (M1, M2, M3, M4…).

There are two formats:

  • .deb — recommended for Ubuntu, Debian, Mint and derivatives. Install it with apt pointing at the file (the ./ is mandatory; that way dependencies resolve on their own):

    Ventana de terminal
    sudo apt install ./context-code-desktop_<versión>_amd64.deb
    context-code-desktop
  • .AppImage — universal, works on any modern x86_64 distribution (Fedora, Arch, openSUSE, Manjaro…). There is nothing to install: give it execute permission and open it.

    Ventana de terminal
    chmod +x context-code-desktop_<versión>_amd64.AppImage
    ./context-code-desktop_<versión>_amd64.AppImage

For a server or a VPS with no graphical environment, the one-line installer:

Ventana de terminal
curl -fsSL https://contextcodedev.iaforged.com/downloads/install.sh | bash

It installs the .deb, verifies its SHA-256 checksum and offers to sign you in. To update, the same command. Then, over SSH:

Ventana de terminal
contextcode chat # the agent in the terminal
contextcode serve --print-qr --public # web/mobile access with QR

All the details are in Context Code from the terminal.

The Android app is installed from Google Play. The downloads page has a QR code that opens its listing straight on your phone: scan it, tap Install and Google Play keeps it up to date.

  • Windows: 64-bit Windows 10/11 with WebView2 (included in Windows 11).
  • macOS: macOS 13 (Ventura) or later, on a Mac with Apple Silicon.
  • Linux: a distribution with webkit2gtk 4.1 — Ubuntu 22.04+, Debian 12+ or equivalent. The .AppImage is the most portable option (on Ubuntu 22.04+ also install libfuse2).
  • Android: Android 7.0 or later.
  • You do not need to install Node, Rust or any development tooling: the installer brings everything with it. Since 3.6.0 that includes the engine for the real-time conversation — the voice agent, the server and the models — so that mode works right after installing and with no internet connection.
  • To use cloud models you will need an account with the provider you choose; for local models, the more RAM (and GPU) you have, the bigger the models you can run.

The next step is connecting an AI provider and opening your first project: continue with Your first chat.

Context Code has a phone app that pairs with your PC by scanning a QR code. The details are in Mobile app.

Each plan allows Context Code to be activated on a maximum number of devices at the same time. If you try to activate it on one more, the app tells you and offers Add a device.

  1. Click Add a device in the app notice, or go to My account on the website and, under Devices on your plan, click Add device. There you can see how many devices you use and how many your plan allows.
  2. Each extra device costs 10 USD per month on monthly plans or 100 USD per year on yearly plans. Confirming creates a pending request with that price; you can cancel it while it is still pending.
  3. Make the payment through the channel you are given. Once it is confirmed, the request is approved and your limit goes up.
  4. In the app, click I already paid / revalidate and the device that was blocked is activated.

If the request is rejected, you will see the reason in My account.