Installation

Get PPM installed on your system quickly and easily

Installation

PPM provides multiple installation methods to suit different preferences and environments. Choose the method that works best for your setup.

Quick Install (Recommended)

The fastest way to get PPM running on your system:

Windows

Open PowerShell as Administrator and run:

Invoke-WebRequest https://raw.githubusercontent.com/VesperAkshay/polypm/main/install.ps1 -UseBasicParsing | Invoke-Expression

This will:

• Download the latest PPM binary
• Install it to your system PATH
• Verify the installation

The installer scripts automatically detect your operating system and architecture, downloading the appropriate binary for your system.

Manual Installation

If you prefer to install PPM manually or the quick install doesn’t work for your setup:

Download Pre-built Binaries

Download the latest release for your platform from GitHub:

Windows x64

.exe file for Windows 64-bit

Linux x64

Binary for Linux 64-bit

macOS Universal

Universal binary for Intel and Apple Silicon

Installation Steps

1. Download the Binary

   Download the appropriate binary for your operating system from the links above.

2. Make it Executable (macOS/Linux)

   chmod +x ppm-*
   

3. Move to System PATH

   macOS/Linux:

   sudo mv ppm-* /usr/local/bin/ppm
   

   Windows:

   • Rename the file to ppm.exe
   • Move it to a directory in your PATH (e.g., C:\Program Files\PPM\)
   • Add that directory to your system PATH if needed
4. Verify Installation

   ppm --version
   

Build from Source

For developers who want to build PPM from source or contribute to the project:

Prerequisites

• Rust 1.75 or later
• Git

Build Steps

1. Clone the Repository

   git clone https://github.com/VesperAkshay/polypm.git
   cd polypm
   

2. Build the Project

   cargo build --release
   

3. Install Locally

   cargo install --path .
   

   This installs PPM to your Cargo bin directory (usually ~/.cargo/bin/).

4. Verify Installation

   ppm --version
   

Package Managers

PPM will be available through popular package managers soon:

Homebrew (macOS/Linux)

# Coming soon
brew install ppm

Homebrew formula is in development

System Requirements

PPM has minimal system requirements:

Platform	Minimum Requirements
Windows	Windows 10 or later (x64)
macOS	macOS 10.15 or later (Intel/Apple Silicon)
Linux	Any modern distribution (x64)

Required Dependencies

PPM manages JavaScript and Python projects, so you’ll need:

• Node.js (version 14 or later) - for JavaScript projects
• Python (version 3.8 or later) - for Python projects

PPM can work with projects that only use one language, but its real power comes from managing polyglot projects that use both JavaScript and Python.

Verification

After installation, verify that PPM is working correctly:

# Check version
ppm --version

# Check available commands
ppm --help

# Test with a simple project
ppm init test-project
cd test-project
ppm install

Troubleshooting

Common Issues

Command not found: ppm

Solution: The PPM binary is not in your system PATH.

• Windows: Add the PPM installation directory to your PATH environment variable
• macOS/Linux: Make sure /usr/local/bin is in your PATH, or move PPM to a directory that is

Permission denied (macOS/Linux)

Solution: The binary doesn’t have execute permissions.

chmod +x /usr/local/bin/ppm

Windows SmartScreen warning

Solution: Windows may show a security warning for unsigned binaries.

• Click “More info” then “Run anyway”
• This is normal for open-source software without expensive code signing certificates

SSL/TLS errors during download

Solution: Your system’s certificates might be outdated.

• Update your system
• Try downloading manually from the GitHub releases page

Getting Help

If you encounter issues not covered here:

1. Check the GitHub Issues for known problems
2. Search GitHub Discussions for community help
3. Create a new issue with details about your system and the error

Uninstallation

To uninstall PPM from your system:

Windows

Invoke-WebRequest https://raw.githubusercontent.com/VesperAkshay/polypm/main/uninstall.ps1 -UseBasicParsing | Invoke-Expression

---

Ready to get started? Head to the Quick Start Guide to build your first polyglot project!