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

# praisonai uninstall

> Cleanly remove the managed PraisonAI CLI environment and shim

Cleanly remove the PraisonAI CLI — `praisonai uninstall` deletes the managed environment and global shim that the one-line installer created.

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai uninstall
```

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    A[🧩 Detect install]:::agent --> B{Confirm?}:::config
    B -->|Yes / --yes| C[🗑️ Remove managed env + shim]:::process
    B -->|No| D[↩️ Cancelled]:::result
    C --> E[✅ Removed]:::result

    classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef process fill:#189AB4,stroke:#7C90A0,color:#fff
    classDef config fill:#6366F1,stroke:#7C90A0,color:#fff
    classDef result fill:#10B981,stroke:#7C90A0,color:#fff
```

<Note>
  This is CLI self-management only. The core `praisonaiagents` SDK is not removed by this command.
</Note>

## Quick Start

<Steps>
  <Step title="Interactive uninstall">
    Prompts for confirmation, then removes the managed install:

    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai uninstall
    ```

    ```
    Remove PraisonAI 1.3.0 (installed via uv)? [y/N]
    ```
  </Step>

  <Step title="Non-interactive (CI)">
    Skip the prompt with `--yes` (or `-y`):

    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai uninstall --yes
    ```
  </Step>
</Steps>

***

## What It Removes

| Removed                                           | Not touched                          |
| ------------------------------------------------- | ------------------------------------ |
| The managed environment (`uv tool` / `pipx` venv) | Your `~/.praison/` config and state  |
| The global `praisonai` shim on your `PATH`        | Any provider API keys you configured |

The command detects how the CLI was installed and runs the matching removal command:

| Install type   | Uninstall command run         |
| -------------- | ----------------------------- |
| `uv`-managed   | `uv tool uninstall praisonai` |
| `pipx`-managed | `pipx uninstall praisonai`    |
| plain `pip`    | `pip uninstall -y praisonai`  |

<Warning>
  If the install type can't be self-managed, the command prints a clear manual fallback (for example `pip uninstall praisonai`) and exits non-zero rather than deleting anything unexpectedly.
</Warning>

***

## Flags

| Flag          | Description                                                                      |
| ------------- | -------------------------------------------------------------------------------- |
| `--yes`, `-y` | Skip the confirmation prompt (non-interactive / CI).                             |
| `--json`      | Global flag — emit machine-readable output (`{"manager": ..., "removed": ...}`). |

<Tabs>
  <Tab title="Human output">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai uninstall --yes
    ```

    ```
    PraisonAI 1.3.0 removed.
    ```
  </Tab>

  <Tab title="JSON output">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai --json uninstall --yes
    ```

    ```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    {"manager": "uv", "removed": "1.3.0"}
    ```
  </Tab>
</Tabs>

***

## Best Practices

<AccordionGroup>
  <Accordion title="Use --yes in scripts and CI">
    Non-interactive shells have no TTY for the confirmation prompt. Pass `--yes` (or `--json`) to run cleanly in automation.
  </Accordion>

  <Accordion title="Keep your config if you plan to reinstall">
    `praisonai uninstall` leaves `~/.praison/` in place, so a later reinstall keeps your settings and cache. Remove that directory manually only if you want a fully clean slate.
  </Accordion>
</AccordionGroup>

***

## Related

<CardGroup cols={2}>
  <Card title="praisonai upgrade" icon="circle-arrow-up" href="/docs/cli/upgrade">
    Update the managed CLI install in place
  </Card>

  <Card title="Installer Internals" icon="gear" href="/docs/install/installer">
    How the one-line installer works
  </Card>

  <Card title="Installation" icon="download" href="/docs/installation">
    Install paths for CLI and SDK users
  </Card>

  <Card title="Isolation Backends" icon="box" href="/docs/install/isolation-backends">
    uv, pipx, and venv explained
  </Card>
</CardGroup>