CapIXCapIX

Apps on the Fabric

CapixIDE & CapIX Code

The desktop and CLI tools for the CapIX compute fabric. Architect, code, and deploy from your editor or terminal.

๐Ÿค–

Agent Built In

The CapIX agent lives in your editor. Describe what you want, it architects and deploys.

๐Ÿš€

Real Infrastructure

Deploy VMs, GPUs, containers, and models from your editor. No cloud account needed.

๐ŸŒ

Same Fabric

Your deployments, models, and receipts sync across web, CLI, and IDE.

๐Ÿงพ

Verifiable

Every action has a receipt. See exactly what you're charged and why.

Quick Start

Up and running in 2 minutes

1

Download

Get CapixIDE for your platform

2

Sign In

Connect your CapIX account

3

Build

Describe what you want to deploy

4

Deploy

Watch it go live on the fabric

Download

Get the apps

CapixIDE

The desktop workspace

Verifiable build

A full IDE with the CapIX agent built in. Architect, code, and deploy without leaving your editor.

macOS ยท arm64
Download 2.3.14

SHA-256: 2f946e75c9f23c9e909a08f5fdc96086d0085e5477b9bbefce4f8e4749e86890

macOS ยท x64
Download 2.3.14

SHA-256: d45cf53b464de4f852f5f7bd56eb199670a5c25027035340584cafc59cc99987

Linux ยท x64
Download 2.3.14

SHA-256: ea24a3b7b5cd1e0bb25bbd4ef28ad098271027fdcbe0281c0703126508cc9a0b

Windows ยท x64
Download 2.3.14

SHA-256: bc394c7642fbadd41004ec7d7586824c183472bc7df4a3fc43b86a335da8dddc

CapIX Code

The CLI agent

Verifiable build

Terminal-native agent that architects, codes, and deploys from any shell. Same fabric, same account.

macOS ยท arm64
Download 2.4.9

SHA-256: 611d4d840576ec474a59bd29ef36430fb6e03808ef43bc8bdd8fc3a89286d11e

macOS ยท x64
Download 2.4.9

SHA-256: 32cc371e0151b254c68eb1dc7aea750665c64d717a2093656872a41a81f8fe6f

Linux ยท x64
Download 2.4.9

SHA-256: 3c64599d5f8b87e83b3cad27b97042173aa4fd19659cf2dde14be05d3124b25a

Linux ยท arm64
Download 2.4.9

SHA-256: 39435113ea90645ea83dd03269c16eb696478eb8ecf908011f32639342240918

Windows ยท x64
Download 2.4.9

SHA-256: 39999f7a76c03a61efbfe9f616fe4036879a9da788f8ccffa900caf93805ee74

Installation

One-line install

Copy, paste, done. Each command verifies the SHA-256 checksum before installing.

CapixIDE

Desktop app

# macOS & Linux
curl -fsSL https://raw.githubusercontent.com/CapIX-Protocol/CapIX-IDE/main/scripts/ide-install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/CapIX-Protocol/CapIX-IDE/main/scripts/ide-install.ps1 | iex

Installs to /Applications/CapixIDE.app (macOS) or ~/.local/share/capix-ide (Linux). On macOS, control-click the app โ†’ Open to bypass Gatekeeper for the unsigned build.

CapIX Code

CLI agent

# macOS & Linux โ€” verified binary (recommended)
# Add --setup-path to auto-add ~/.local/bin to PATH on macOS
curl -fsSL https://raw.githubusercontent.com/CapIX-Protocol/CapIX-Code/main/scripts/install.sh \
  | bash -s -- v2.4.19 --setup-path
# All platforms โ€” npm (Node.js 20+)
npm install -g capix-code@2.4.19

Installs to ~/.local/bin/capix-code (curl) or your npm global bin (npm). Verify with capix-code --version. If npm errors with EACCES, see the FAQ below.

Verify your install

capix-code --version       # โ†’ capix-code 2.4.19
capix-code doctor          # health check: auth, runtime, providers
capix-code login           # browser-based login to your CapIX account

Launch CapixIDE from your Applications folder / Start Menu and sign in via the Accounts panel. Verify the version in: CapixIDE menu โ†’ About.

Troubleshooting

Common install issues & fixes

The most frequent failure modes โ€” and the one-line fix for each.

npm install fails with EACCES / permission deniedโ–พ

npm's default install location is /usr/local/lib/node_modules, which needs root. Don't use sudo โ€” it makes things worse later.

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
npm install -g capix-code@2.4.19
macOS: "developer cannot be verified" / "damaged and can't be opened"โ–พ

CapixIDE is currently unsigned. Gatekeeper blocks it on first launch. Strip the quarantine attribute:

xattr -dr com.apple.quarantine /Applications/CapixIDE.app
open /Applications/CapixIDE.app
capix-code: command not found after installโ–พ

~/.local/bin or~/.npm-global/bin isn't on your PATH. Re-run the curl installer with --setup-path to add it automatically:

curl -fsSL https://raw.githubusercontent.com/CapIX-Protocol/CapIX-Code/main/scripts/install.sh \
  | bash -s -- v2.4.19 --setup-path

Or add the export manually: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc.

Windows: SmartScreen "protected your PC"โ–พ

CapixIDE and CapIX Code Windows binaries are unsigned. Click More info โ†’ Run anyway. To pre-allow a file: right-click โ†’ Properties โ†’ check Unblock โ†’ OK. Don't disable SmartScreen globally.

Debug JSON lines are spilling across the TUIโ–พ

The TUI renders its own status surface; raw log lines from the broker / provider should never spill into the terminal. If you see JSON lines like"level":"warn","message":"capix-broker: ..." appearing across the screen, raise the log level back to its default:

# Silence info + warn; only errors reach stderr
export CAPIX_LOG_LEVEL=error

# Or, for one command:
CAPIX_LOG_LEVEL=error capix-code

# Verify:
capix-code --version  # should print just the version, no JSON

If the issue persists, the binary build may be stale โ€” reinstall from the latest tag: curl -fsSL https://raw.githubusercontent.com/CapIX-Protocol/CapIX-Code/main/scripts/install.sh | bash -s -- v2.4.19

npm postinstall failed / EISDIRโ–พ

A previous install left a conflicting symlink. Run the repair script, or fall back to the curl install:

curl -fsSL https://raw.githubusercontent.com/CapIX-Protocol/CapIX-Code/main/scripts/fix-capix-install.sh | bash
capix-code --version
Linux: missing libnss3.so / libatk-1.0.so.0โ–พ

CapixIDE is an Electron app and needs the standard Chromium runtime libraries.

# Debian / Ubuntu
sudo apt-get install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 \
  libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 \
  libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 libasound2

# Fedora / RHEL
sudo dnf install -y nss atk cups-libs libdrm libxkbcommon \
  libXcomposite libXdamage libXfixes libXrandr libgbm pango alsa-lib
Checksum verification failedโ–พ

Usually a corrupt download โ€” interrupted network, proxy, or antivirus interference. Clear the cache and retry:

rm -rf /tmp/capix-* /tmp/capix-code-install.*
curl -fsSL https://raw.githubusercontent.com/CapIX-Protocol/CapIX-Code/main/scripts/install.sh \
  | bash -s -- v2.4.19

If it fails twice from different networks, file an issue atgithub.com/CapIX-Protocol/CapIX-Code/issues with the SHA-256 you got and the version tag.

Full install guide + 13-entry FAQ โ†’

Covers Node version, OAuth callback port conflicts, all-lanes-failed errors, local-stack ECONNREFUSED, xcode-select, and more.

Every build is verifiable

These builds are unsigned for now โ€” macOS notarization is on the roadmap. Until then, every artifact ships with a SHA-256 checksum so you can prove exactly what you downloaded. One command, ten seconds:

# macOS / Linux โ€” one line verifies the whole artifact
shasum -a 256 -c CapixIDE-v2.3.14-darwin-arm64-unsigned.tar.gz.sha256

# Windows (PowerShell)
Get-FileHash .\CapixIDE-v2.3.14-win32-x64-unsigned.zip -Algorithm SHA256

Compare the output against the checksum beside each download and on the GitHub release page. Do not run the binary if the hashes do not match exactly.

โ† Back to CapIX
CapIX | CapixIDE & CapIX Code โ€” Downloads