> ## Documentation Index
> Fetch the complete documentation index at: https://kaiser.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PPM - Polyglot Package Manager

> The unified package manager for JavaScript and Python projects. Manage dependencies across multiple ecosystems seamlessly.

<img className="block dark:hidden" src="https://mintcdn.com/kaiser/72JCtNpbtBvXH9SQ/images/hero-light.png?fit=max&auto=format&n=72JCtNpbtBvXH9SQ&q=85&s=56410e02c66fb12fdda403a319b90d4a" alt="PPM Hero Light" width="1024" height="535" data-path="images/hero-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/kaiser/72JCtNpbtBvXH9SQ/images/hero-dark.png?fit=max&auto=format&n=72JCtNpbtBvXH9SQ&q=85&s=731abf2a63073ded488461a8c5f0489f" alt="PPM Hero Dark" width="1024" height="535" data-path="images/hero-dark.png" />

# Welcome to PPM

**PPM (Polyglot Package Manager)** is a revolutionary tool that simplifies dependency management for modern polyglot applications. Instead of juggling multiple package managers, PPM provides a unified interface for JavaScript and Python dependencies.

## Why PPM?

<CardGroup cols={2}>
  <Card title="Unified Dependencies" icon="package">
    Manage npm and pip packages from a single `project.toml` file
  </Card>

  <Card title="Instant Setup" icon="bolt">
    Go from `git clone` to running application in just 2 commands
  </Card>

  <Card title="Environment Management" icon="layer-group">
    Automatic Python virtual environments and Node.js version handling
  </Card>

  <Card title="Cross-Platform" icon="desktop">
    Works seamlessly on Windows, macOS, and Linux
  </Card>
</CardGroup>

## The Problem PPM Solves

Modern applications often use multiple programming languages:

* **Frontend**: React, Vue, or Angular (JavaScript/TypeScript)
* **Backend**: Flask, Django, or FastAPI (Python)
* **Data Processing**: NumPy, Pandas (Python)
* **Build Tools**: Webpack, Vite (JavaScript)

Managing dependencies across these ecosystems is complex and time-consuming:

<CodeGroup>
  ```bash Traditional Way (Without PPM) theme={null}
  # Frontend setup
  cd frontend
  npm install
  npm run dev

  # Backend setup (separate terminal)
  cd ../backend
  python -m venv venv
  source venv/bin/activate  # Windows: venv\Scripts\activate
  pip install -r requirements.txt
  python app.py
  ```

  ```bash The PPM Way theme={null}
  # Everything in one go
  ppm install
  ppm run dev
  ```
</CodeGroup>

## Quick Start

Get up and running with PPM in under 2 minutes:

<Steps>
  <Step title="Install PPM">
    **Windows (PowerShell):**

    ```powershell theme={null}
    Invoke-WebRequest https://raw.githubusercontent.com/VesperAkshay/polypm/main/install.ps1 -UseBasicParsing | Invoke-Expression
    ```

    **Linux/macOS (Bash):**

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/VesperAkshay/polypm/main/install.sh | bash
    ```
  </Step>

  <Step title="Create a New Project">
    ```bash theme={null}
    ppm init my-awesome-app
    cd my-awesome-app
    ```
  </Step>

  <Step title="Install Dependencies">
    ```bash theme={null}
    ppm install
    ```
  </Step>

  <Step title="Run Your Application">
    ```bash theme={null}
    ppm run dev
    ```
  </Step>
</Steps>

## Key Features

### 🎯 **Single Configuration File**

One `project.toml` file manages all your dependencies across languages:

```toml theme={null}
[project]
name = "my-app"
version = "1.0.0"

[dependencies.js]
react = "^18.2.0"
axios = "^1.6.0"

[dependencies.python]
flask = "^3.0.0"
numpy = "^1.24.0"
```

### 🚀 **Productivity Boost**

* **20% time savings** on environment setup
* **Days to seconds** for new developer onboarding
* **Single interface** for all package management tasks

### 🔒 **Enterprise Ready**

* Lock file support for reproducible builds
* Security vulnerability scanning across ecosystems
* CI/CD integration with major platforms

## Real-World Impact

<CardGroup cols={3}>
  <Card title="Developer Productivity">
    Save 3-4 hours per week on environment management
  </Card>

  <Card title="Team Onboarding">
    New developers productive in minutes, not days
  </Card>

  <Card title="Deployment Simplicity">
    Consistent environments from development to production
  </Card>
</CardGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Installation Guide" icon="download" href="/installation">
    Get PPM installed on your system
  </Card>

  <Card title="Quick Start Tutorial" icon="rocket" href="/quickstart">
    Build your first polyglot application
  </Card>

  <Card title="Configuration Guide" icon="gear" href="/configuration">
    Learn about project.toml configuration
  </Card>

  <Card title="See Examples" icon="code" href="/examples/react-flask">
    Explore real-world project examples
  </Card>
</CardGroup>

***

<Note>
  PPM is open source and actively maintained. Join our community on [GitHub](https://github.com/VesperAkshay/polypm) to contribute, report issues, or request features.
</Note>