Installation

This guide will help you install Sciorex on your system.

System Requirements

Requirement	Minimum
OS	Windows 10+, macOS 11+, Ubuntu 20.04+
RAM	4 GB
Disk Space	200 MB
AI Provider	At least one CLI installed (see below)

Download

Download the latest version for your platform:

Windows

Version	Download
Installer (.exe)	Download
Portable (.zip)	Download

macOS

Architecture	Download
Apple Silicon (M1/M2/M3/M4)	Download
Intel	Download

Linux

Format	Download
AppImage	Download
Debian/Ubuntu (.deb)	Download

Installing AI Provider CLIs

Sciorex supports multiple AI providers. Install at least one to use AI features.

Claude Code (Anthropic)

Claude models including Opus 4.5, Sonnet 4.5, and Haiku 4.5.

👉 Claude Code Installation

claude login

Gemini CLI (Google)

Gemini models including 2.5 Pro, 2.5 Flash, and 2.5 Flash Lite.

👉 Gemini CLI Installation

gemini auth login

Codex CLI (OpenAI)

GPT and Codex models including GPT-5.2, GPT-5.1 Codex Max, and more.

👉 Codex CLI Installation

codex auth

Local Models (Optional)

For local/private AI, install one of:

• LM Studio - GUI app with local model server
• Ollama - CLI for running local models

Sciorex will automatically detect available models from these servers.

Mix and Match

You can install multiple providers and switch between them per agent or chat session. Configure providers in Settings → AI Providers.

First Launch

1. Launch Sciorex
2. Select or create a workspace folder
3. Configure your default AI model in Settings
4. You're ready to create your first agent!

Updating

Sciorex includes auto-update functionality. When a new version is available:

1. You'll see a notification in the app
2. Click "Update Now" to download and install
3. Restart the app to apply the update

Portable Version

The portable version does not auto-update. Download new versions manually.

Troubleshooting

CLI not found

Make sure your AI CLI is in your PATH:

# macOS/Linux
which claude   # Claude Code
which gemini   # Gemini CLI
which codex    # Codex CLI

# Windows
where claude
where gemini
where codex

If not found, follow the installation guide for your provider above.

Permission errors on Linux

For AppImage, make it executable:

chmod +x Sciorex-*.AppImage

macOS security warning

If macOS blocks the app:

1. Open System Preferences → Security & Privacy
2. Click "Open Anyway" next to the blocked app message

Next Steps

• Quick Start - Create your first agent
• Settings - Configure Sciorex
• Troubleshooting - Solve common issues
• FAQ - Common questions answered