Skip to content
GitHub Actions edited this page Jun 23, 2026 · 4 revisions

NeuralMimicry Continuum (NMC) — Wiki Home

NMC is the release and operate control plane for the NeuralMimicry platform. It ships two C++ binaries — nmc (operator CLI) and nmc_server (HTTP control plane) — covering Kubernetes/vcluster management, Tracey fleet telemetry, VM and node operations, and provider portal orchestration.

☕ Support NeuralMimicry on Crowdfunder


Quick navigation

Page Description
Getting Started Build the CLI and server from source
CLI Reference All nmc subcommands with examples
Server Configuration Auth modes, port, kubeconfig, environment variables
Tracey Integration Fleet telemetry, adaptive planning, and assessment
Deployment Ansible role, Debian packages, systemd service
Contributing Build dependencies, preflight script, PR guidelines

Build

# CLI
cmake -S nmc_client -B nmc_client/build
cmake --build nmc_client/build -j4

# Server
cmake -S nmc_server -B nmc_server/build
cmake --build nmc_server/build -j4

Common CLI commands

./nmc_client/build/nmc --help
./nmc_client/build/nmc connection make local http://127.0.0.1:8080 --default
./nmc_client/build/nmc server health
./nmc_client/build/nmc k8s list
./nmc_client/build/nmc vcluster create demo --namespace vcluster-demo
./nmc_client/build/nmc tracey fleet
./nmc_client/build/nmc tracey adaptive
./nmc_client/build/nmc refiner deploy --manifest ./refiner-k8s.yaml --namespace refiner
./nmc_client/build/nmc refiner status --namespace refiner

Server auth modes

Mode Description
token (default) Authorization: Bearer <token> or X-NMC-Token
oidc OIDC-based authentication
off No authentication (development only)

Set via NMC_AUTH_MODE environment variable.

Get involved