> ## 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.

# Version

> Version information and update checking

The `version` command displays version information and checks for updates. Available from both `praisonai-code` (standalone) and `praisonai` (full wrapper).

## Usage

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-code version [OPTIONS] COMMAND [ARGS]...
praisonai version [OPTIONS] COMMAND [ARGS]...
```

## Commands

| Command | Description                                                 |
| ------- | ----------------------------------------------------------- |
| `show`  | Show version information (default when no subcommand given) |
| `check` | Check PyPI for a newer release                              |

## Examples

### Show version panel

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-code version
praisonai-code version show
```

Output (text mode):

```
╭─ Version Information ─────────────────────────────╮
│ PraisonAI Code: 0.0.4                             │
│ PraisonAI Wrapper: 1.x.x  ← only when installed  │
│ PraisonAI Agents: 1.6.x                           │
│ Python: 3.12.x                                    │
╰───────────────────────────────────────────────────╯
```

The `PraisonAI Wrapper` line is omitted when `praisonai` is not installed.

### Show version as JSON

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-code version show --json
```

JSON output keys:

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "praisonai-code": "0.0.4",
  "praisonai": "1.x.x",
  "praisonaiagents": "1.6.x",
  "python": "3.12.x"
}
```

The `praisonai` key is omitted when the wrapper package is not installed.

### Check for updates

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-code version check
```

Queries `https://pypi.org/pypi/praisonai-code/json` and returns:

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "current": "0.0.4",
  "latest": "0.0.5",
  "update_available": true
}
```

<Note>
  `version check` requires outbound HTTPS access to PyPI. In air-gapped environments, the command exits with an error message instead.
</Note>

### Quick version flag

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

Prints only the `praisonai-code` package version string and exits immediately.

## See Also

* [Doctor](/docs/cli/doctor) - Health checks
* [PraisonAI Code CLI](/docs/features/praisonai-code-cli) - Standalone CLI overview

## Standalone `praisonai-code` binary

The same `version` group works when you invoke the **`praisonai-code`** console script or `python -m praisonai_code`.

### Default (`version show`)

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-code version
# or
praisonai-code version show
```

Human-readable panel fields:

| Line              | When shown                                                |
| ----------------- | --------------------------------------------------------- |
| PraisonAI Code    | Always — version from `praisonai-code` package metadata   |
| PraisonAI Wrapper | Only when `praisonai` is importable                       |
| PraisonAI Agents  | Always — `praisonaiagents.__version__` or `not installed` |
| Python            | Always — `major.minor.micro`                              |

Quick one-liner (Typer global option, not the panel above):

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

### JSON (`version show`)

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-code version --json
```

Keys emitted:

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "praisonai-code": "0.0.4",
  "praisonai": "4.6.106",
  "praisonaiagents": "1.6.101",
  "python": "3.12.0"
}
```

The `praisonai` key is omitted when the wrapper is not installed.

### Check for updates

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-code version check
```

Compares the installed `praisonai-code` version with [PyPI](https://pypi.org/pypi/praisonai-code/json).

<Note>
  `version check` requires outbound HTTPS to PyPI.
</Note>

JSON shape:

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "current": "0.0.4",
  "latest": "0.0.4",
  "update_available": false
}
```

On failure, JSON mode may include `"latest": null` and an `"error"` string instead.