MirrorNeuron Deploy

mn-deploy contains the unified installer and local service scripts for MirrorNeuron. By default, install.sh installs released artifacts and Python packages.

Quick Start

Inspect installer options:

./install.sh --help

Install the local runtime:

./install.sh

Install a specific release:

./install.sh --version v1.2.8

Install from the published URL:

curl -fsSL https://mirrorneuron.io/install.sh | bash

Ask before each install choice:

./install.sh --interactive

Install from GitHub repositories:

./install.sh --mode github

Check or control installed services:

./server.sh status
./server.sh start
./server.sh stop

Clear runtime Redis state:

./scripts/clear-redis.sh --yes

Details

• Google Artifact Registry Python Publishing
• MirrorNeuron Component Guide
• Installation
• Docker and OpenShell for Blueprints
• Security Model

Notes

• Default runtime state is stored under ~/.mn. The installer also keeps a shell profile export for both MirrorNeuron and OtterDesk: export MN_HOME="$HOME/.mn".

• Generated Compose settings are stored in ~/.mn/docker-compose.env.

• Redis defaults to the Docker Official Image redis:8, which includes Redis Query Engine support for vector search. Set MN_REDIS_IMAGE before install or in ~/.mn/docker-compose.env to pin a specific Redis 8+ tag or digest.

• The installer can set up the core, SDK, CLI, API, Web UI, Redis, and OpenShell depending on selected options. The Membrane context engine is provisioned lazily when a blueprint that requires context memory runs.

• Installs are non-interactive by default and use yes/default selections. Use --interactive for the prompt-driven setup flow.

• Use ./install.sh or ./install.sh --mode binary for release/package installs, ./install.sh --mode github for repository installs, or ./install.sh --mode local from a monorepo checkout for editable local installs.

• Use --version v1.2.8 to install a matching released set of core, CLI, SDK, API, Web UI, package metadata, and runtime support files.

• Versioned installer support files live under install_support/<version>/. Create a release snapshot with:

  ./save_install_support.sh --version v1.2.8

• For URL installs without a local checkout, the installer downloads the versioned runtime Docker Compose template and binary package index from the public mn-deploy GitHub repository.

• Initial installs skip the Membrane context engine by default to keep setup light. Use --context-engine with MN_MEMBRANE_DIR or a readable MN_MEMBRANE_GIT_URL to enable it during install instead of waiting for the first context-memory blueprint run.

• Python packages published to Google Artifact Registry are controlled by package-index/python-packages.toml.

• Binary mode uses the current public package repository by default: https://us-central1-python.pkg.dev/mirrorneuron-public-packages/agent-skills/simple/.

• GAR setup:

  ./setup_google_artifact_registry.sh \
    --project mirrorneuron-public-packages \
    --location us-central1 \
    --repository agent-skills

• GAR publish/sync dry run:

  ./publish_python_packages_to_google_artifact_registry.sh \
    --project mirrorneuron-public-packages \
    --location us-central1 \
    --repository agent-skills

• GAR publish/sync apply:

  ./publish_python_packages_to_google_artifact_registry.sh \
    --apply \
    --project mirrorneuron-public-packages \
    --location us-central1 \
    --repository agent-skills

• Public Membrane Rust binary and Docker image GAR dry run:

  ./publish_public_membrane_to_google_artifact_registry.sh \
    --version v1.2.8

• Public Membrane Rust binary and Docker image GAR apply:

  ./publish_public_membrane_to_google_artifact_registry.sh \
    --apply \
    --version v1.2.8

• Public Otterdesk desktop app package GAR apply:

  ./publish_public_otterdesk_to_google_artifact_registry.sh \
    --apply \
    --version v1.2.8