Requirements

Platform, runtime, and model prerequisites for Comis

You don’t need to understand the technical details to use this feature. The configuration examples below are copy-paste ready.

Supported deployment posture

• Linux: primary production platform. The installer targets common systemd-based distributions.
• macOS: development and local evaluation. Apple’s sandbox-exec is deprecated, so do not treat it as the Linux production isolation boundary.
• Docker: use a Linux Docker host for production. Docker Desktop on macOS or Windows is appropriate for development and testing.

npm installation prerequisites

• Node.js 22.19.0 or newer
• npm
• Python 3
• a C/C++ build toolchain for native dependencies
• outbound HTTPS for the package registry and any networked providers or tools

Install Node.js from your distribution or the official Node.js download instructions, then add the native build tools for your platform. On Debian or Ubuntu:

sudo apt-get update
sudo apt-get install -y build-essential python3

On Fedora or RHEL:

sudo dnf install -y gcc-c++ make python3

On macOS:

xcode-select --install
brew install node@22

Confirm the actual Node.js patch version after installation:

node --version
npm --version
python3 --version

node --version must be at least v22.19.0.

Model access

At least one usable model path is required:

Path	Credential requirement	Notes
Hosted API provider	Provider API credential	Store it through the wizard or comis secrets set
Supported OAuth provider	Provider account and interactive/device login	Complete login from a TTY
Local provider	No hosted API credential	Start the local provider before verification

Comis supports several hosted providers; availability, model names, and account terms are controlled by those providers. See Models and the configuration reference for the current surface.

Capacity

Resource needs depend on traffic, enabled channels, browser/media tools, conversation retention, and whether models or embeddings run locally. Allow additional memory and disk for Chromium, local models, and growing SQLite data. Monitor the host under representative workload rather than relying on a single minimum specification.

Next steps

Quickstart

Install and run the staged setup wizard.

Docker

Use the Linux container deployment path.