Installation and Operations

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 operational details, limits, and exact flags anchored to INSTALL.md.

What this guide covers

This page is the user-oriented map for:

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

Quick install

Windows

git clone https://github.com/icidade/miniCISO.git
cd miniCISO
.\scriptsootstrap.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/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.

Bootstrap summary

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

Offline validation

./scripts/validate-repo.sh

Online smoke test

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

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

Update

See the canonical update instructions in INSTALL.md.

Rollback

See the canonical rollback section in INSTALL.md.

Limitations

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:

• Troubleshooting and FAQ
• INSTALL.md
• docs/dependencies-and-configuration.md