Implement install stages S0–S2: bootstrap, env, model and vision smoke.
Operator can run make bootstrap/install through S2 using nemohermes/openshell wrappers; docs and implement queue updated. No S3+ and no push.
This commit is contained in:
+37
-11
@@ -1,29 +1,55 @@
|
||||
# Deployer host baselining
|
||||
|
||||
**Status:** Outline from approved design POR. Procedural scripts at **build**.
|
||||
**Status:** Procedural — ready for operator use.
|
||||
|
||||
## Purpose
|
||||
|
||||
Create a clean host that can run the Docker-based Lumina stack. This product is **repo-driven**, not tied to one developer’s existing Hermes install.
|
||||
Create a clean host that can run the Docker-based Lumina stack. This product is **repo-driven**, not tied to one developer's existing Hermes install.
|
||||
|
||||
## Requirements (POR)
|
||||
## Requirements
|
||||
|
||||
| Item | Spec |
|
||||
|------|------|
|
||||
| OS | Linux x86_64 or arm64 (cloud VM, bare metal; WSL2 optional path only) |
|
||||
| Resources | Multi-core CPU; ≥8–16 GB RAM recommended; disk for Docker images |
|
||||
| Privileges | User able to install Docker / run Compose |
|
||||
| Privileges | User able to install Docker / run Compose (sudo access) |
|
||||
| Network | Outbound HTTPS to model endpoint, SaaS APIs, MCP remotes, image registry |
|
||||
| GPU | Optional; only if local VLM is used (not required if vision is remote) |
|
||||
|
||||
## Steps (operator)
|
||||
## Prerequisites (before running scripts)
|
||||
|
||||
1. Provision host (cloud console / hypervisor).
|
||||
2. Install base OS updates.
|
||||
3. Create deploy user; clone this repository.
|
||||
4. Run `./scripts/bootstrap.sh` (installs Docker if missing — when implemented).
|
||||
5. Continue with [INSTALL.md](INSTALL.md).
|
||||
1. **Provision host** — cloud console, hypervisor, or bare metal.
|
||||
2. **Install base OS updates** — `sudo apt update && sudo apt upgrade -y` (Debian/Ubuntu) or equivalent.
|
||||
3. **Create deploy user** — a non-root user with sudo access.
|
||||
4. **Install NemoClaw CLIs** — `nemohermes` and `openshell` must be on PATH. See [NemoClaw docs](https://docs.nvidia.com/nemoclaw/latest/user-guide/hermes/reference/architecture.md) for installation.
|
||||
5. **Clone this repository** — `git clone <repo-url> && cd Salon_Assistant`.
|
||||
|
||||
## Bootstrap (S0b)
|
||||
|
||||
Run the bootstrap script to install Docker if missing:
|
||||
|
||||
```bash
|
||||
./scripts/bootstrap.sh
|
||||
```
|
||||
|
||||
Or via Make:
|
||||
|
||||
```bash
|
||||
make bootstrap
|
||||
```
|
||||
|
||||
**What it does:**
|
||||
- Detects if Docker is already installed and running (idempotent).
|
||||
- If missing, installs Docker via the official convenience script (Debian/Ubuntu) or dnf (RHEL/Fedora).
|
||||
- Adds the current user to the `docker` group.
|
||||
- Verifies the Docker daemon is reachable.
|
||||
|
||||
**If Docker is already present:** the script detects it and exits immediately with a success message.
|
||||
|
||||
## Continue with install
|
||||
|
||||
After bootstrap, proceed to [INSTALL.md](INSTALL.md) for stages S1–S2.
|
||||
|
||||
## Design reference
|
||||
|
||||
[design/DESIGN_PLAN.md](../design/DESIGN_PLAN.md) § Docker packaging and install stages.
|
||||
[design/DESIGN_PLAN.md](../design/DESIGN_PLAN.md) §4 Docker packaging and install stages.
|
||||
|
||||
Reference in New Issue
Block a user