Neural Nations · CAMS Raw Scorer · Local Edition · Universal

CAMS Scorer — Local Edition

A standalone Windows tool that runs the same CAMS raw-scoring ensemble as the online CAMS Scorer, entirely on your own machine, using your own key for the provider of your choice — OpenAI, Grok (xAI), Claude (Anthropic), or Kimi (Moonshot AI). Nothing is sent to Neural Nations — the tool talks directly to whichever provider you pick, and you're billed directly by them at your account's own rates. Runs are capped at a 9-year range and a choice of 1, 3, or 5 passes per request, whichever provider you use.

Universal edition — Windows, all four providers

cams-scorer-gui-universal.exe EASIEST
Windows app · ~23 MB · double-click to open, pick a provider from a dropdown, no command line needed
Download
cams-scorer-universal.exe
Windows command line (advanced) · ~20 MB
Download

Linux / WSL OpenAI only

cams-scorer-linux
Linux / WSL command line (x86-64), OpenAI only · ~16 MB
Download
Windows SmartScreen will likely flag these on first run, since they're new, unsigned executables from an independent publisher. Click "More info" → "Run anyway" if you trust the source. You can also read the plain-text README or inspect the source repo first.

Using the app (recommended for most people)

  1. Download cams-scorer-gui-universal.exe above and double-click it to open.
  2. Pick a provider from the dropdown — OpenAI, Grok, Claude, or Kimi.
  3. The first time you use a given provider, it'll ask for that provider's API key: OpenAI, Grok, Claude, or Kimi. Each provider's key is saved separately on your PC, so switching providers later won't lose the others.
  4. Choose what you're scoring (country, company, or city), type the name, pick a year range (max 9 years), and a pass count (1, 3, or 5), then click Run scoring pass.
  5. Watch the progress log, then see the scores appear in the table. Results are also saved as CSV files in your Documents\CAMS Scorer Output folder — click Open output folder to find them.

3 passes carries roughly 85% of the ensemble signal relative to a larger run, so it's a reasonable ceiling for a single pass of research; 1 or 2 passes trade some of that reliability for speed.

Using the command line (advanced)

  1. Get an API key for whichever provider you want: OpenAI, Grok, Claude, or Kimi.
  2. Open a terminal (PowerShell) in the folder where you saved cams-scorer-universal.exe.
  3. Set the matching key for the session: $env:OPENAI_API_KEY, $env:XAI_API_KEY, $env:ANTHROPIC_API_KEY, or $env:KIMI_API_KEY — whichever provider you're passing as the first argument.
  4. Run a scoring pass, naming the provider first — see examples below. Runs are capped at a 9-year range and 1, 3, or 5 passes.
# OpenAI, country, single year, default 3 passes
$env:OPENAI_API_KEY = "sk-..."
.\cams-scorer-universal.exe openai country USA 2020 2024

# Grok, company
$env:XAI_API_KEY = "xai-..."
.\cams-scorer-universal.exe grok company Tesla 2023

# Claude, city, fewer passes, faster
$env:ANTHROPIC_API_KEY = "sk-ant-..."
.\cams-scorer-universal.exe claude city Detroit 2019 2023 --passes 2

# Kimi, country
$env:KIMI_API_KEY = "sk-..."
.\cams-scorer-universal.exe kimi country Japan 2023

Each pass is a separate live model call — a 3-pass run typically takes a couple of minutes. Two CSVs are written to the current folder: <entity>_cams_scores.csv (ensemble mean per node) and <entity>_cams_envelope.csv (uncertainty — standard deviation and valid-pass count per cell). This is raw scoring only — no Node Value, Bond Strength, or diagnosis. See the model page for the full CAMS calculation pipeline.

Setup — Linux / WSL (OpenAI only)

  1. Get an OpenAI API key at platform.openai.com/api-keys.
  2. Open a terminal in the folder where you saved cams-scorer-linux, then mark it executable: chmod +x cams-scorer-linux
  3. Set your key for the session: export OPENAI_API_KEY="sk-..."
  4. Run a scoring pass — see examples below.
# country, single year, default 5 passes
./cams-scorer-linux country USA 2020 2024

# company
./cams-scorer-linux company Tesla 2023

# city, fewer passes, faster
./cams-scorer-linux city Detroit 2019 2023 --passes 3

The Linux binary is the older single-provider (OpenAI) build and doesn't share the universal edition's 9-year/1-3-5-pass caps or provider choice. Windows users should use the universal edition above instead.