Windows, macOS, Linux에 NME 설치하기

현재 NME 0.0.1-beta.160는 beta 브랜치의 소스에서 설치합니다. Git, Cargo가 포함된 안정 Rust, Python 3.8 이상이 필요합니다. 공식 Rust 설치, Python 다운로드, Git 다운로드를 이용하세요. 아래에서 운영체제를 고르세요. 각 절만으로 끝까지 따라 할 수 있습니다.

#Windows 11

1. Git for Windows를 설치합니다.
2. python.org에서 Python을 설치하고 Python 실행기 py를 유지합니다.
3. 공식 Rust 설치 페이지에서 rustup-init.exe를 받아 실행합니다. 안정 MSVC 도구 체인을 고릅니다. 요청이 나오면 Visual Studio C++ Build Tools(무료 Microsoft 구성 요소로, Cargo가 빌드에 필요)도 설치합니다.
4. PowerShell을 닫았다 다시 열고 실행합니다. nme 네이티브(영어 nme native)를 사용하려면 cl.exe가 PATH에 들어 있는 Visual Studio Developer PowerShell을 여세요. CPython 명령에는 일반 PowerShell이면 충분합니다.

git clone --branch beta https://github.com/needmoretruth/needmoreeasy.git
cd needmoreeasy
cargo install --path crates/nme-cli --locked
$env:Path = "$HOME\.cargo\bin;$env:Path"
nme --version

NME 버전은 0.0.1-beta.160가 표시되어야 합니다. $env:Path 줄은 방금 설치한 명령을 현재 PowerShell에서 바로 찾게 합니다.

다음 터미널을 위한 PATH 설정. 새 PowerShell에서도 nme를 찾지 못하면 %USERPROFILE%\.cargo\bin을 사용자 PATH에 추가하세요. 다시 설치할 필요는 없으며 & "$HOME\.cargo\bin\nme.exe" --version으로 설치된 파일을 직접 확인할 수 있습니다.

첫 NME 실행(리포지토리를 복제한 needmoreeasy 폴더에서). NME가 Windows의 py 실행기를 자동으로 고릅니다.

nme 실행 examples\hello-sentence

흔한 오류.

• nme를 찾지 못함: ~\.cargo\bin이 사용자 PATH에 없습니다. %USERPROFILE%\.cargo\bin을 추가하거나 & "$HOME\.cargo\bin\nme.exe" --version으로 파일이 있는지 확인하세요.
• Cargo 빌드가 링크 또는 컴파일러 오류로 실패: 3단계의 Visual Studio C++ Build Tools가 빠졌습니다. rustup-init.exe를 다시 실행하고 설치를 고르세요.
• nme 실행에서 Python을 찾지 못함: 2단계에서 Python 3.8 이상을 Python 실행기(py)와 함께 설치했는지 확인하세요.

#Windows 10

Windows 10은 Windows 11과 같은 방식으로 설치합니다. 이 절만으로 따라 할 수 있도록 전체 단계를 다시 적었습니다.

1. Git for Windows를 설치합니다.
2. python.org에서 Python을 설치하고 Python 실행기 py를 유지합니다.
3. 공식 Rust 설치 페이지에서 rustup-init.exe를 받아 실행합니다. 안정 MSVC 도구 체인을 고릅니다. 요청이 나오면 Visual Studio C++ Build Tools(무료 Microsoft 구성 요소로, Cargo가 빌드에 필요)도 설치합니다.
4. PowerShell을 닫았다 다시 열고 실행합니다. nme 네이티브(영어 nme native)를 사용하려면 cl.exe가 PATH에 들어 있는 Visual Studio Developer PowerShell을 여세요. CPython 명령에는 일반 PowerShell이면 충분합니다.

git clone --branch beta https://github.com/needmoretruth/needmoreeasy.git
cd needmoreeasy
cargo install --path crates/nme-cli --locked
$env:Path = "$HOME\.cargo\bin;$env:Path"
nme --version

NME 버전은 0.0.1-beta.160가 표시되어야 합니다. $env:Path 줄은 방금 설치한 명령을 현재 PowerShell에서 바로 찾게 합니다.

다음 터미널을 위한 PATH 설정. 새 PowerShell에서도 nme를 찾지 못하면 %USERPROFILE%\.cargo\bin을 사용자 PATH에 추가하세요. 다시 설치할 필요는 없으며 & "$HOME\.cargo\bin\nme.exe" --version으로 설치된 파일을 직접 확인할 수 있습니다.

첫 NME 실행(리포지토리를 복제한 needmoreeasy 폴더에서). NME가 Windows의 py 실행기를 자동으로 고릅니다.

nme 실행 examples\hello-sentence

흔한 오류.

• nme를 찾지 못함: ~\.cargo\bin이 사용자 PATH에 없습니다. %USERPROFILE%\.cargo\bin을 추가하거나 & "$HOME\.cargo\bin\nme.exe" --version으로 파일이 있는지 확인하세요.
• Cargo 빌드가 링크 또는 컴파일러 오류로 실패: 3단계의 Visual Studio C++ Build Tools가 빠졌습니다. rustup-init.exe를 다시 실행하고 설치를 고르세요.
• nme 실행에서 Python을 찾지 못함: 2단계에서 Python 3.8 이상을 Python 실행기(py)와 함께 설치했는지 확인하세요.

#이전 Windows(7, 8)

공식 경로는 Windows 10 또는 11입니다. 현재 버전의 rustup 설치 프로그램과 Visual Studio C++ Build Tools는 Windows 10 이상을 요구하므로 Windows 7이나 8에서 NME 명령줄 도구를 소스에서 빌드하는 것은 지원되지 않습니다.

그래도 동작하는 것: NME 프로그램은 순수 Python이 되며, Python 3.8이 Windows 7과 8에서 실행되는 가장 최신 Python입니다. Windows 10/11에서 만든 프로그램 파일을 Windows 7/8 컴퓨터에 복사해 그 Python으로 실행할 수 있습니다. NME 명령줄 도구 자체는 Windows 10 또는 11이 필요합니다.

#macOS

Git이 없다면 Xcode 명령줄 도구를 설치합니다.

xcode-select --install

python.org에서 현재 Python을 설치하고 공식 rustup 페이지의 명령으로 Rust를 설치합니다. 같은 단계가 인텔과 Apple Silicon(M 시리즈) Mac 모두에서 동일하게 동작하며 python.org 설치 프로그램이 두 종류를 모두 지원합니다. 새 터미널을 열고 (리포지토리를 복제한 needmoreeasy 폴더에서) 실행하세요.

git clone --branch beta https://github.com/needmoretruth/needmoreeasy.git
cd needmoreeasy
cargo install --path crates/nme-cli --locked
export PATH="${CARGO_HOME:-$HOME/.cargo}/bin:$PATH"
nme --version

NME 버전은 0.0.1-beta.160가 표시되어야 합니다. Cargo가 바이너리 폴더가 PATH에 없다고 경고하면 첫 nme 명령보다 export 줄을 먼저 실행해야 합니다.

다음 터미널을 위한 PATH 설정. export 줄을 다음 터미널에도 유지하려면 같은 줄을 macOS 기본 셸의 ~/.zshrc 또는 사용 중인 셸의 프로필에 추가하세요. rustup으로 Rust를 설치했다면 다음 명령이 같은 설정을 이미 제공할 수 있습니다.

source "$HOME/.cargo/env"

첫 NME 실행:

nme 실행 examples/hello-sentence

흔한 오류.

• 새 터미널에서 nme를 찾지 못함: export 줄이 아직 저장되지 않았습니다. ~/.zshrc 또는 사용 중인 셸 프로필에 추가하세요.
• Cargo 빌드가 컴파일러 오류로 실패: Xcode 명령줄 도구가 없습니다. xcode-select --install을 실행하고 다시 시도하세요.

#Debian과 Ubuntu

apt로 Python, Git, C 빌드 도구, curl을 설치하고 rustup으로 안정 Rust를 설치합니다(공식 rustup 페이지에 나온 명령).

sudo apt install python3 python3-pip git curl build-essential
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

python3-pip는 아래 선택 사항인 Nuitka 단계에서만 필요합니다. 새 셸을 열고 (리포지토리를 복제한 needmoreeasy 폴더에서) 실행합니다.

git clone --branch beta https://github.com/needmoretruth/needmoreeasy.git
cd needmoreeasy
cargo install --path crates/nme-cli --locked
export PATH="${CARGO_HOME:-$HOME/.cargo}/bin:$PATH"
nme --version

NME 버전은 0.0.1-beta.160가 표시되어야 합니다. export 줄을 의도적으로 첫 nme 명령보다 앞에 두었습니다.

첫 NME 실행:

nme 실행 examples/hello-sentence

다음 터미널을 위한 PATH 설정. 새 터미널에서도 nme를 찾지 못하면 export 줄을 ~/.bashrc, ~/.zshrc 또는 사용 중인 셸 프로필에 추가하세요. 패키지 관리자로 설치한 Cargo는 설치에 성공해도 ~/.cargo/bin을 셸의 PATH에 자동으로 넣지 않을 수 있습니다. 필요하면 "${CARGO_HOME:-$HOME/.cargo}/bin/nme" --version으로 설치 파일을 직접 확인하세요.

흔한 오류.

• nme를 찾지 못함: export 줄을 ~/.bashrc(또는 셸 프로필)에 추가하고 새 터미널을 여세요.
• rustup 명령 직후 cargo나 rustup을 찾지 못함: 현재 셸은 설치 전에 열렸습니다. 새 셸을 열거나 source "$HOME/.cargo/env"를 실행하세요.
• 선택 Nuitka 단계에서 "No module named pip" 오류: python3-pip를 설치하세요(위 설치 명령에 포함되어 있습니다).

#Fedora

dnf로 Python, Git, C 빌드 도구, curl을 설치하고 rustup으로 안정 Rust를 설치합니다(공식 rustup 페이지에 나온 명령).

sudo dnf install python3 python3-pip git curl gcc
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

python3-pip는 아래 선택 사항인 Nuitka 단계에서만 필요합니다. 새 셸을 열고 (리포지토리를 복제한 needmoreeasy 폴더에서) 실행합니다.

git clone --branch beta https://github.com/needmoretruth/needmoreeasy.git
cd needmoreeasy
cargo install --path crates/nme-cli --locked
export PATH="${CARGO_HOME:-$HOME/.cargo}/bin:$PATH"
nme --version

NME 버전은 0.0.1-beta.160가 표시되어야 합니다. export 줄을 의도적으로 첫 nme 명령보다 앞에 두었습니다.

첫 NME 실행:

nme 실행 examples/hello-sentence

다음 터미널을 위한 PATH 설정. Fedora의 시스템 cargo 같은 패키지 관리자 버전은 설치에 성공해도 ~/.cargo/bin을 셸의 PATH에 자동으로 넣지 않을 수 있습니다. 필요하면 "${CARGO_HOME:-$HOME/.cargo}/bin/nme" --version으로 설치 파일을 직접 확인한 뒤, 같은 export 줄을 ~/.bashrc, ~/.zshrc 또는 사용 중인 셸 프로필에 추가하세요.

흔한 오류.

• nme를 찾지 못함: export 줄을 ~/.bashrc(또는 셸 프로필)에 추가하고 새 터미널을 여세요.
• rustup 명령 직후 cargo나 rustup을 찾지 못함: 현재 셸은 설치 전에 열렸습니다. 새 셸을 열거나 source "$HOME/.cargo/env"를 실행하세요.
• 선택 Nuitka 단계에서 "No module named pip" 오류: python3-pip를 설치하세요(위 설치 명령에 포함되어 있습니다).

#Arch Linux

pacman으로 Python, Git, C 빌드 도구, curl을 설치하고 rustup으로 안정 Rust를 설치합니다(공식 rustup 페이지에 나온 명령).

sudo pacman -S python python-pip git curl base-devel
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

python-pip는 아래 선택 사항인 Nuitka 단계에서만 필요합니다. 새 셸을 열고 (리포지토리를 복제한 needmoreeasy 폴더에서) 실행합니다.

git clone --branch beta https://github.com/needmoretruth/needmoreeasy.git
cd needmoreeasy
cargo install --path crates/nme-cli --locked
export PATH="${CARGO_HOME:-$HOME/.cargo}/bin:$PATH"
nme --version

NME 버전은 0.0.1-beta.160가 표시되어야 합니다. export 줄을 의도적으로 첫 nme 명령보다 앞에 두었습니다.

첫 NME 실행:

nme 실행 examples/hello-sentence

다음 터미널을 위한 PATH 설정. 새 터미널에서도 nme를 찾지 못하면 export 줄을 ~/.bashrc, ~/.zshrc 또는 사용 중인 셸 프로필에 추가하세요. 패키지 관리자로 설치한 Cargo는 설치에 성공해도 ~/.cargo/bin을 셸의 PATH에 자동으로 넣지 않을 수 있습니다. 필요하면 "${CARGO_HOME:-$HOME/.cargo}/bin/nme" --version으로 설치 파일을 직접 확인하세요.

흔한 오류.

• nme를 찾지 못함: export 줄을 ~/.bashrc(또는 셸 프로필)에 추가하고 새 터미널을 여세요.
• rustup 명령 직후 cargo나 rustup을 찾지 못함: 현재 셸은 설치 전에 열렸습니다. 새 셸을 열거나 source "$HOME/.cargo/env"를 실행하세요.
• 선택 Nuitka 단계에서 "No module named pip" 오류: python-pip를 설치하세요(위 설치 명령에 포함되어 있습니다).

#전체 도구 확인

nme --version
nme 모듈
nme 검사 examples/three-levels
nme 실행 examples/hello-sentence

NME는 0.0.1-beta.160, 랜덤 어댑터는 0.0.1이 표시되어야 합니다.

#고급: 다른 Python 명령 고르기

NME가 Windows에서는 py, 그 밖의 운영체제에서는 python3를 자동으로 사용합니다. 특수한 환경에서만 고급 옵션을 씁니다.

nme 실행 program --python python
nme 컴파일 program -o program --python python

Windows에서는 마지막 값을 py로 바꾸세요.

#선택적인 독립 실행 파일

평범한 빌드는 완전한 Python 호환성을 유지하는 Python 소스를 만듭니다. 컴파일은 외부 Nuitka 컴파일러로 한 파일짜리 독립 실행 결과물을 만듭니다.

python3 -m pip install -U "Nuitka[app]"
python3 -m nuitka --version
nme 컴파일 examples/hello-sentence -o hello

Nuitka에는 운영체제용 C 컴파일러가 필요합니다. 복잡한 프로그램은 한 파일 모드 전에 standalone 모드로 검사할 것을 Nuitka가 권장합니다. NME 명령은 가장 쉬운 전달을 위해 한 파일 모드를 사용합니다. 데이터 파일이나 네이티브 패키지가 있으면 공식 Nuitka 시작 안내와 사용자 설명서를 읽으세요.

Windows용 파일은 Windows에서, macOS용은 macOS에서, Linux용은 Linux에서 각각 빌드해야 합니다.

#업데이트 또는 삭제

beta를 업데이트하고 다시 설치합니다.

git switch beta
git pull --ff-only
cargo install --path crates/nme-cli --locked --force

설치한 CLI를 지웁니다.

cargo uninstall nme-cli

실행 명령은 nme, Cargo 패키지 이름은 nme-cli입니다.