Installation
This guide walks you through installing Sciorex and configuring your AI provider of choice. Sciorex supports 6 AI CLIs out of the box.
System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| OS | Windows 10, macOS 12, Ubuntu 20.04 | Windows 11, macOS 14, Ubuntu 22.04+ |
| RAM | 4 GB | 8 GB+ |
| Disk | 500 MB | 1 GB+ |
| Node.js | 18.0+ | 20.0+ (LTS) |
| Git | 2.30+ | Latest |
Download & Install
Download the latest version from the Sciorex website or from GitLab Releases.
| Platform | Format |
|---|---|
| Windows | .msi installer |
| macOS | .dmg disk image |
| Linux | .AppImage, .deb, .rpm |
Run the installer and follow the on-screen instructions.
Supported AI Providers
Sciorex works with 6 AI CLIs. You only need one to get started, but you can configure multiple providers and switch between them at any time.
Claude Code
Anthropic's official CLI for Claude models.
- Website: docs.anthropic.com/en/docs/claude-code
- Models: Claude Opus 4.6, Sonnet 5.0, Sonnet 4, Haiku 3.5
Follow the installation instructions on the Claude Code website. Once installed, authenticate via claude login or set your API key.
Gemini CLI
Google's command-line tool for Gemini models.
- Website: github.com/google-gemini/gemini-cli
- Models: Gemini 3 Pro, 3 Flash Preview, 2.5 Pro, 2.5 Flash
Follow the installation instructions on the Gemini CLI repository. Authenticate via gemini auth login or set your API key.
Codex
OpenAI's CLI agent for GPT and Codex models.
- Website: github.com/openai/codex
- Models: GPT-5.3 Codex, GPT-4.1, o4-mini
Follow the installation instructions on the Codex repository. Set your OpenAI API key to get started.
OpenCode
Open-source CLI that supports multiple model providers.
- Website: github.com/opencode-ai/opencode
- Models: All models from configured providers (Anthropic, OpenAI, Google, or local)
Follow the installation instructions on the OpenCode repository. Run opencode to launch the interactive configuration wizard and select your preferred provider.
Local Models
Run models locally for privacy, offline work, or cost savings:
- Ollama: ollama.ai — Run models locally with a single command
- LM Studio: lmstudio.ai — Desktop app for local model management
Install your preferred runtime from its website, then point Sciorex to the local server in Settings > AI Provider.
Post-Installation
After installing Sciorex and at least one AI provider:
- Launch Sciorex from your terminal or application launcher
- Select your provider in Settings > AI Provider
- Verify the connection by sending a test message in chat
- Explore MCP tools - Sciorex exposes 59 tools across 6 servers automatically
Updating
Sciorex checks for updates automatically on launch. You can also check manually via the command palette (Ctrl+Shift+P > "Check for Updates").
To update, download the latest version from the Sciorex website or GitLab Releases and run the installer.
Troubleshooting
| Issue | Solution |
|---|---|
| CLI not found | Ensure the provider CLI is in your PATH |
| API key invalid | Re-export or re-login with your provider |
| Connection timeout | Check firewall rules and proxy settings |
| MCP tools missing | Restart Sciorex to re-initialize servers |
For more help, visit GitLab Issues or join our Discord.