> ## Documentation Index
> Fetch the complete documentation index at: https://comis-fix-skill-import-vetting-gate.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Requirements

> Platform, runtime, and model prerequisites for Comis

<Info>
  You don't need to understand the technical details to use this feature. The configuration examples below are copy-paste ready.
</Info>

## 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](https://nodejs.org/en/download), then add the native build tools
for your platform. On Debian or Ubuntu:

```bash theme={}
sudo apt-get update
sudo apt-get install -y build-essential python3
```

On Fedora or RHEL:

```bash theme={}
sudo dnf install -y gcc-c++ make python3
```

On macOS:

```bash theme={}
xcode-select --install
brew install node@22
```

Confirm the actual Node.js patch version after installation:

```bash theme={}
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](/agents/models) and the
[configuration reference](/reference/config-yaml) 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

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/get-started/quickstart">
    Install and run the staged setup wizard.
  </Card>

  <Card title="Docker" icon="docker" href="/installation/install-docker">
    Use the Linux container deployment path.
  </Card>
</CardGroup>