Installation

Download pre-built binaries or build from source.

v0.99-beta | Windows, macOS, Linux

Quick Install (Pre-built Binaries)

# Download (Intel/AMD)
curl -LO https://github.com/neural-commander/nc/releases/latest/download/neural-commander-linux-amd64
chmod +x neural-commander-linux-amd64
sudo mv neural-commander-linux-amd64 /usr/local/bin/nc

# Or ARM64 (Raspberry Pi, etc.)
curl -LO https://github.com/neural-commander/nc/releases/latest/download/neural-commander-linux-arm64

# Verify installation
nc version

# Apple Silicon (M1/M2/M3/M4)
curl -LO https://github.com/neural-commander/nc/releases/latest/download/neural-commander-mac-m1
chmod +x neural-commander-mac-m1
sudo mv neural-commander-mac-m1 /usr/local/bin/nc

# Intel Mac
curl -LO https://github.com/neural-commander/nc/releases/latest/download/neural-commander-darwin-amd64

# If macOS blocks the binary (Gatekeeper)
xattr -d com.apple.quarantine /usr/local/bin/nc

# Verify installation
nc version

# Download from GitHub Releases
curl -LO https://github.com/neural-commander/nc/releases/latest/download/neural-commander-windows-amd64.exe

# Move to PATH (PowerShell as Admin)
move neural-commander-windows-amd64.exe C:\Windows\System32\nc.exe

# Or add to user PATH
mkdir %USERPROFILE%\bin
move neural-commander-windows-amd64.exe %USERPROFILE%\bin\nc.exe

# Verify installation
nc version

All releases available at GitHub Releases

Build from Source

Prerequisites

Requirement	Version	Install
Go	1.21+	golang.org/dl
Git	2.0+	`apt install git` / `brew install git`
Make	Any	Usually pre-installed

Build Steps

# 1. Clone the repository
git clone https://github.com/neural-commander/neural-commander.git
cd neural-commander/neural-commander-go

# 2. Build with Make (recommended)
make build-community

# Or build with Go directly
go build -o nc ./cmd/nc

# 3. Install globally
sudo cp ./dist/neural-commander /usr/local/bin/nc

# 4. Verify
nc version

Cross-platform builds: Run make build-all to compile for all 5 platforms (Linux AMD64/ARM64, macOS Intel/Apple Silicon, Windows).

Platform Notes

🐧

Linux

• AMD64 and ARM64 supported
• chmod +x required
• Systemd service available

🍎

macOS

• Native Apple Silicon binary
• No Rosetta required
• Use xattr -d for Gatekeeper

🪟

Windows

• 64-bit only
• WSL2 auto-detected
• Native filesystem recommended

⚡

WSL2 Performance Tip

NC detects WSL2 automatically. For best performance, store projects in the native Linux filesystem instead of Windows mounts:

# Slow (Windows mount)
/mnt/c/dev/projects/myproject

# Fast (Native Linux)
~/projects/myproject

Verification

# Check version
nc version

# Quick health scan
nc audit . --quick

# Check daemon status
nc daemon status

Troubleshooting

"Command not found"

Ensure the binary is in your PATH:

echo $PATH
export PATH=$PATH:/usr/local/bin

"Permission denied"

chmod +x /path/to/nc

Build fails with Go errors

# Ensure Go 1.21+
go version

# Update dependencies
go mod tidy

Uninstalling

sudo rm /usr/local/bin/nc
rm -rf ~/.neural-commander

del C:\Windows\System32\nc.exe
rd /s %USERPROFILE%\.neural-commander

Next Steps