hermes profile home %q not found (create it with `hermes pro

Error message

hermes profile home %q not found (create it with `hermes profile create`)

What it means

Error "hermes profile home %q not found (create it with `hermes profile create`)" thrown in multica-ai/multica.

Source

Thrown at server/internal/daemon/execenv/hermes_home.go:389

// source home is absent — set for an explicitly named profile so a typo doesn't
// silently seed from an empty dir and drop the user's auth/config. env is the
// sanitized effective env used to expand ${VAR} in external_dirs so it matches
// what the Hermes child sees. memoryStore is the agent's persistent memory store
// (execenv.HermesMemoryStorePath) that memories/ is linked to; empty keeps
// memories/ task-local for this task. sessionStore is the conversation's
// persistent session store (execenv.HermesSessionStorePath) that state.db is
// linked to; empty — or a host that cannot create the link — keeps the session
// database task-local. The returned hermesSessionMount reports both what got
// mounted and whether the store actually holds a transcript, so the caller never
// tells a task it can resume history that is not there.
func prepareHermesHome(hermesHome, sourceHome string, sourceMustExist bool, workspaceSkills []SkillContextForEnv, env map[string]string, memoryStore, sessionStore string, logger *slog.Logger) (sessions hermesSessionMount, err error) {
	sharedHome := strings.TrimSpace(sourceHome)
	if sharedHome == "" {
		sharedHome = platformDefaultHermesHome()
	}
	if sourceMustExist {
		if fi, err := os.Stat(sharedHome); err != nil || !fi.IsDir() {
			return hermesSessionMount{}, fmt.Errorf("hermes profile home %q not found (create it with `hermes profile create`)", sharedHome)
		}
	}

	if err := os.MkdirAll(hermesHome, 0o700); err != nil {
		return hermesSessionMount{}, fmt.Errorf("create hermes-home dir: %w", err)
	}
	// Tighten perms on reuse too — MkdirAll leaves an existing dir's mode alone,
	// and the derived config below can hold inline api_key secrets.
	if err := os.Chmod(hermesHome, 0o700); err != nil {
		return hermesSessionMount{}, fmt.Errorf("chmod hermes-home dir: %w", err)
	}
	if err := prepareHermesTaskLocalState(hermesHome); err != nil {
		return hermesSessionMount{}, fmt.Errorf("prepare task-local state: %w", err)
	}
	// Sessions: link state.db at the conversation's persistent store so the
	// transcript survives the task. A store that cannot be mounted leaves the
	// database task-local — the pre-existing behaviour — rather than failing the
	// task. See hermes_sessions.go.

View on GitHub (pinned to 2c0912b6ec)

Solutions

Create the profile with 'hermes profile create' first.

When it happens

Trigger: Thrown at server/internal/daemon/execenv/hermes_home.go:389 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of multica-ai/multica@2c0912b6ec (2026-08-15). Data as JSON: /api/errors/e7c35fec7962838b. Report an issue: GitHub.