# What Are the System Requirements for Hallmark: Complete Installation Guide

> Discover the essential system requirements for Hallmark installation including Node.js Python and browser needs. Get your Hallmark project set up quickly.

- Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark)
- Tags: getting-started
- Published: 2026-07-26

---

**You need Node.js 14 LTS or higher (with npm) to install Hallmark, optionally Python 3 for local previews, and a modern web browser to view generated static pages.**

Hallmark is a design skill for AI coding assistants that generates static HTML and CSS pages. Before installing the tool from the `Nutlope/hallmark` repository, verify that your environment meets these specific system requirements for Hallmark to function correctly.

## Core System Requirements

### Node.js and npm (Mandatory)

Node.js version 14 LTS or higher is the primary runtime dependency. According to the installation instructions in [`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md) (line 96), the skill installs via `npx`, which requires Node.js and the bundled npm package manager to resolve the package from the registry.

```bash
npx skills add nutlope/hallmark

```

### Python 3 (Optional)

For local development previews, Python 3 is recommended but not required. The `serve` script defined in [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json) (line 33) utilizes `python3 -m http.server` to launch a local HTTP server on port 4173.

```bash
npm run serve

```

### Modern Web Browser

The generated pages rely on modern CSS features including custom properties, `clamp()`, `@media` queries, and `overflow-x: clip`. Compatible browsers include Chrome ≥89, Firefox ≥86, Safari ≥14, and Edge ≥89.

### Internet Access

Network connectivity is required only during the initial installation phase when `npx` fetches the package from the npm registry. As implemented in the offline-capable architecture, the skill works entirely after installation with no further network calls required.

## Installation Process

The primary installation method uses the `npx` command to fetch the skill from npm. As documented in the repository's [`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md), execute the following in your terminal:

```bash
npx skills add nutlope/hallmark

```

The [`site/index.html`](https://github.com/Nutlope/hallmark/blob/main/site/index.html) file (line 826) contains the install UI that references this same command for users accessing the web interface at usehallmark.com.

## Local Preview Configuration

To preview generated static sites locally after cloning the repository, use the convenience script defined in [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json):

```bash

# Requires Python 3 installed

npm run serve

```

This command starts a local server at `http://localhost:4173`, allowing you to view the generated site before deployment.

## AI Assistant Integration

Once installed, Hallmark runs as a skill inside Claude Code, Cursor, and Codex. The skill definition in [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) specifies the available verbs (such as `redesign`) that these assistants consume to generate static HTML and CSS output.

## Summary

- **Node.js ≥14 LTS** is mandatory for executing `npx skills add nutlope/hallmark`
- **npm** installs automatically with Node.js and handles package resolution from the registry
- **Python 3** enables the optional `npm run serve` local preview functionality
- **Modern browsers** (Chrome 89+, Firefox 86+, Safari 14+, Edge 89+) correctly render the generated CSS utilizing modern features
- **Internet connection** is only required during the installation step; the skill operates offline thereafter

## Frequently Asked Questions

### Do I need Python to use Hallmark?

No. Python 3 is only required if you want to run the local preview server using `npm run serve`. The core skill functionality works without Python installed, as the skill generates static files that can be opened directly in a browser or served by any HTTP server.

### What AI coding assistants support Hallmark?

According to [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md), Hallmark runs inside Claude Code, Cursor, and Codex. The skill definition file specifies the verbs and capabilities consumed by these assistants, including the `redesign` command for transforming project files.

### Can I use Hallmark without internet access?

Yes, but only after the initial installation. The `npx` command requires internet connectivity to download the package from npm as stated in the installation UI ([`site/index.html`](https://github.com/Nutlope/hallmark/blob/main/site/index.html), line 826). After the skill is installed, it operates completely offline with no external API dependencies.

### What Node.js versions are supported?

Hallmark requires Node.js 14 LTS or higher. The `npx` command used in the installation process ([`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md), line 96) is compatible with Node.js 14+ environments, which is the minimum version supporting the package resolution features required by the skill distribution mechanism.