Skip to content

Installation and Operations

Hermes Agent edited this page Jul 11, 2026 · 2 revisions

Installation and Operations

This page is explanatory. The canonical installation guide is INSTALL.md.

Overview

Use the repository bootstrap to restore the pinned Hermes runtime and the MiniCISO overlay. Keep exact flags, limits, and platform-specific edge cases anchored to INSTALL.md.

What this guide covers

This page is the short operator map for:

  • prerequisites;
  • quick install;
  • platform variants;
  • provider/model setup;
  • bootstrap behavior;
  • validation and smoke testing;
  • update and rollback;
  • common operational issues.

Quick install

Windows

git clone https://github.com/icidade/miniCISO.git
cd miniCISO
.\scripts\bootstrap.ps1

Linux / macOS / WSL

git clone https://github.com/icidade/miniCISO.git
cd miniCISO
./scripts/bootstrap.sh

Platform notes

  • Windows: use the PowerShell bootstrap and validation scripts.
  • Linux/macOS/WSL: use the Bash scripts.
  • VPS: keep private state outside the public repository and review diffs carefully before publishing safe exports.

Provider and model setup

Provider setup is interactive because credentials do not belong in Git. MiniCISO assumes the user keeps those credentials in the Hermes environment rather than in this repo.

What bootstrap does

Bootstrap restores the pinned runtime, creates the profile set, installs prompts and templates, prepares the workspace, and runs structural checks.

Validate after bootstrap

Offline validation:

./scripts/validate-repo.sh

Online smoke test:

./scripts/smoke-test.sh --online

Use online mode only when you want to spend provider tokens to verify profile responses.

Update and rollback

Limits to keep in mind

MiniCISO is an overlay. Some runtime dependencies, provider support, and isolation properties are inherited from Hermes and the host environment.

Troubleshooting pointers

If bootstrap or validation fails, start with:

Clone this wiki locally