Installation

Installation

TitanX ships as an Electron desktop app. Three paths below — pick the one that matches your OS.

---

🍎 macOS

Apple Silicon (M1/M2/M3/M4)

1. Download the latest arm64 build:

   • TitanX-2.5.1-mac-arm64.dmg (254 MB)

2. Open the DMG, drag TitanX.app to Applications.

3. First launch requires a workaround — our builds aren't Apple-notarized (open-source + no paid Developer ID), so Gatekeeper flags them. Two ways to proceed:

   Option A (recommended): right-click TitanX.app → Open → confirm "Open" on the dialog. macOS remembers this choice.

   Option B (CLI):

   xattr -cr /Applications/TitanX.app
   open /Applications/TitanX.app

Intel Mac

1. Download TitanX-2.5.1-mac-x64.dmg (248 MB) instead.
2. Follow the same steps as above.

Verify the download

shasum -a 256 ~/Downloads/TitanX-2.5.1-mac-arm64.dmg
# Compare against the SHA256 in the GitHub release page

---

🐧 Linux

AppImage (universal)

# Download
curl -LO https://github.com/CES-Ltd/TitanX/releases/latest/download/TitanX-2.5.1.AppImage

# Make executable
chmod +x TitanX-2.5.1.AppImage

# Launch
./TitanX-2.5.1.AppImage

Debian/Ubuntu (.deb)

curl -LO https://github.com/CES-Ltd/TitanX/releases/latest/download/TitanX_2.5.1_amd64.deb
sudo apt install ./TitanX_2.5.1_amd64.deb

Fedora/RHEL (.rpm)

curl -LO https://github.com/CES-Ltd/TitanX/releases/latest/download/TitanX-2.5.1.x86_64.rpm
sudo rpm -i TitanX-2.5.1.x86_64.rpm

Ubuntu quick-install script

A one-shot script covering AppImage + desktop-file integration lives in the main repo:

curl -fsSL https://raw.githubusercontent.com/CES-Ltd/TitanX/main/scripts/install-ubuntu.sh | bash

---

🪟 Windows

⚠️ Windows builds are not currently shipped as release artifacts. The codebase supports Windows (Electron-based, cross-platform), but v2.5.1 publishes macOS + Linux only. Windows users can build from source today — see Development Setup. First-class Windows installers (MSI + NSIS) are on the roadmap for v2.6.

---

🛠 Build from source (any OS)

Useful for contributors, Windows users, or anyone pinning to a specific commit.

Prerequisites

• Bun ≥ 1.2 (curl -fsSL https://bun.sh/install | bash)
• Node ≥ 20 (only for electron-vite's native-module pipeline)
• Git
• Build toolchain for your platform (Xcode Command Line Tools on macOS, build-essential on Linux, MSVC on Windows)

Steps

git clone https://github.com/CES-Ltd/TitanX.git
cd TitanX
bun install
bun run build       # Produces installers in out/
# OR
bun run start       # Launches dev build with hot reload

Artifacts land in out/:

• macOS: .dmg + .zip
• Linux: .AppImage + .deb + .rpm
• Windows: .exe (NSIS) + .msi

---

✅ What to do next

Once TitanX launches cleanly, head to First Launch to walk through the initial setup wizard and pick your first LLM.

---

🆘 Hitting a snag?

• "TitanX is damaged and can't be opened" on macOS → ran xattr -cr above? If still stuck, check console.app for the actual reason.
• App quits silently on Linux → run from terminal to see the stderr; most common cause is a missing system library (libgtk-3-0, libnss3).
• Gatekeeper after xattr -cr → upgrade to macOS 15+ or see Troubleshooting#macos-gatekeeper-still-blocking.

All platform-specific install errors live in Troubleshooting.