Skip to content

Installation Guide

nsyte can be installed in several ways depending on your platform and preferences.

The easiest way to install nsyte is using our universal install script that automatically detects your system and uses the best available method:

curl -fsSL https://nsyte.run/get/install.sh | bash

Or with wget:

wget -qO- https://nsyte.run/get/install.sh | bash

The script will automatically:

  • Detect your operating system (macOS, Linux, Windows)
  • Check for available package managers (Homebrew, Scoop, Chocolatey, AUR, Deno)
  • Install using the best available method
  • Fall back to downloading the latest binary if no package managers are found

Universal Installation

Using Deno

Deno is a modern JavaScript/TypeScript runtime that provides a secure and simple way to run nsyte. This method works on any platform where Deno is installed.

Prerequisites: Deno version 2.0 or later

Install from JSR (recommended):

deno install -A -f -g -n nsyte jsr:@nsyte/cli

Install from GitHub source:

deno install -A -f -g -n nsyte jsr:@nsyte/cli

Command breakdown:

  • -A: Grant all permissions (nsyte needs file system and network access)
  • -f: Force overwrite if nsyte is already installed
  • -g: Install globally
  • -n nsyte: Name the command nsyte

Benefits of Deno installation:

  • Always runs the latest version from source
  • Cross-platform compatibility
  • No compilation needed
  • Easy to modify or fork
  • Secure by default with explicit permissions

To update to the latest version:

# From JSR
deno install -A -f -g -n nsyte jsr:@nsyte/cli

# From GitHub
deno install -A -f -g -n nsyte jsr:@nsyte/cli

To install a specific version:

# From JSR
deno install -A -f -g -n nsyte jsr:@nsyte/cli@0.10.1

# From GitHub
deno install -A -f -g -n nsyte https://raw.githubusercontent.com/sandwichfarm/nsyte/v0.7.0/src/cli.ts

Pre-built Binaries

For users who prefer manual installation or need specific versions, we provide pre-compiled binaries for all major platforms.

Download binaries from the Releases page:

Available platforms:

  • Linux: x86_64 (Intel/AMD 64-bit)
  • macOS: x86_64 (Intel), arm64 (Apple Silicon)
  • Windows: x86_64 (64-bit)

Linux/macOS Manual Installation

  1. Download the appropriate binary for your system:
# For Linux (example)
curl -L -o nsyte https://github.com/sandwichfarm/nsyte/releases/latest/download/nsyte-linux

# For macOS Intel
curl -L -o nsyte https://github.com/sandwichfarm/nsyte/releases/latest/download/nsyte-macos

# For macOS Apple Silicon
curl -L -o nsyte https://github.com/sandwichfarm/nsyte/releases/latest/download/nsyte-macos-arm64
  1. Make the binary executable:
chmod +x nsyte
  1. Move to a directory in your PATH:
# System-wide installation (requires sudo)
sudo mv nsyte /usr/local/bin/

# Or user-local installation
mkdir -p ~/.local/bin
mv nsyte ~/.local/bin/
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
  1. Verify the installation:
nsyte --version

Windows Manual Installation

  1. Download nsyte-windows.exe from the releases page

  2. Rename the file:

  3. Rename nsyte-windows.exe to nsyte.exe

  4. Choose installation location:

  5. Option A: System-wide (requires admin)

    • Move to C:\Program Files\nsyte\
    • Add C:\Program Files\nsyte to system PATH

  6. Option B: User installation

    • Create folder %USERPROFILE%\bin
    • Move nsyte.exe to this folder
    • Add %USERPROFILE%\bin to user PATH

  7. Add to PATH (Windows 10/11):

  8. Open Settings → System → About → Advanced system settings
  9. Click "Environment Variables"
  10. Under "User variables" or "System variables", find "Path"
  11. Click "Edit" → "New"
  12. Add your chosen installation directory

  13. Click "OK" to save

  14. Verify installation (open new Command Prompt):

nsyte --version

Building from Source

If you want to contribute to nsyte, need custom modifications, or want to build from the latest development version, you can compile nsyte from source.

Prerequisites:

  • Deno 2.0 or later
  • Git
  • Basic familiarity with command line

Build Instructions:

  1. Clone the repository:
git clone https://github.com/sandwichfarm/nsyte.git
cd nsyte
  1. Install development dependencies (if any):
# nsyte uses Deno, so no npm install needed!
  1. Build for your current platform:
deno task compile

This creates a binary in the project directory named:

  • nsyte (Linux/macOS)

  • nsyte.exe (Windows)

  • Build for all platforms:

deno task compile:all

This creates binaries for all supported platforms in the dist/ directory.

  1. Install locally:
# Linux/macOS
sudo cp nsyte /usr/local/bin/

# Or install to user directory
mkdir -p ~/.local/bin
cp nsyte ~/.local/bin/

Development Workflow:

For development, you can run nsyte directly without compiling:

deno run -A src/cli.ts --help

Run tests:

deno task test

Format code:

deno fmt

Lint code:

deno lint

Verification and Troubleshooting

Verify Installation

After installation, verify nsyte is working correctly:

# Check version
nsyte --version

# View help
nsyte --help

# Initialize a test project
nsyte init

Common Issues and Solutions

Command not found

  • Ensure the installation directory is in your PATH
  • Restart your terminal or reload your shell configuration
  • For user installations, check ~/.local/bin is in PATH

Permission denied

  • Linux/macOS: Ensure the binary has execute permissions: chmod +x $(which nsyte)
  • Windows: Run as administrator if installed system-wide

Version mismatch

  • Multiple installations may exist, check with: 
    # Linux/macOS
which -a nsyte

# Windows
where nsyte
  • Remove old installations before installing new ones

Network issues during installation

  • Check your internet connection
  • Try using a different installation method
  • For corporate networks, check proxy settings

Missing dependencies

  • Deno installation requires network access to download modules
  • Package manager installations handle dependencies automatically
  • Binary installations have no external dependencies

Getting Help

If you encounter issues:

  1. Check the troubleshooting guide
  2. Search existing issues
  3. Join our community chat
  4. Open a new issue with:
  5. Your operating system and version
  6. Installation method used
  7. Complete error messages
  8. Steps to reproduce

Next Steps

Now that nsyte is installed, you're ready to start publishing to the decentralized web: