Installation

Detailed installation guide for CortexPrism.

System Requirements

  • OS: Linux, macOS, or Windows (native or WSL2)
  • Runtime: Deno v2.0 or later
  • Memory: 4GB RAM minimum (8GB+ recommended)
  • Storage: 500MB for base installation (more for plugin data)

Quick Install

macOS & Linux

curl -fsSL https://cortexprism.io/install.sh | bash

Windows (PowerShell)

irm https://cortexprism.io/install.ps1 | iex

Windows users can also use Git Bash or WSL2 with the macOS/Linux command above.

Install Deno

# macOS / Linux
curl -fsSL https://deno.land/install.sh | sh

# Windows (PowerShell)
iwr https://deno.land/install.ps1 -useb | iex

Or use your package manager:

# macOS (Homebrew)
brew install deno

# Linux (apt/curl)
curl -fsSL https://deno.land/install.sh | sh

# Windows (Scoop)
scoop install deno

# Windows (winget)
winget install DenoLand.Deno

Clone and Setup

# macOS / Linux
git clone https://github.com/CortexPrism/cortex.git
cd cortex
deno run --allow-all src/main.ts setup

# Windows (PowerShell)
git clone https://github.com/CortexPrism/cortex.git
cd cortex
deno run --allow-all src/main.ts setup

The setup command runs database migrations and creates the initial config file.

Pre-compiled Binary

Download the latest binary from the Releases page. All binaries include SHA-256 checksums and optional GPG signatures.

curl -LO https://github.com/CortexPrism/cortex/releases/latest/download/cortex-linux-x64
chmod +x cortex-linux-x64
./cortex-linux-x64 setup
./cortex-linux-x64 chat

Docker Installation

A Docker image is available for containerized deployments:

docker pull cortexprism/cortex:latest

# Interactive chat
docker run -it --rm \
  -v ~/.cortex:/home/cortex/.cortex \
  -e CORTEX_VAULT_KEY=your-passphrase \
  cortexprism/cortex:latest chat

# Run server
docker run -d --rm \
  -p 3000:3000 \
  -v ~/.cortex:/home/cortex/.cortex \
  cortexprism/cortex:latest serve

Verify Installation

cortex --version

You should see the version number printed:

cortex 0.45.3

Next Steps

  • First Run — Walk through your first CortexPrism session
  • Configuration — Learn about configuration options and environment variables