Pure Mode (Suppress Plugins)

Pure Mode skips external-plugin discovery for a single run without touching your saved enable/disable state.

Quick Start

Use the CLI flag

praisonai run --pure "Summarise this file"

Or set the env var

export PRAISONAI_NO_PLUGINS=1
praisonai chat

How It Works

The CLI flag sets PRAISONAI_NO_PLUGINS only for the current run, then restores the prior value on return. The @scopes_no_plugins decorator wraps each command, so suppression is restored on return and never leaks into a later in-process call. The run emits one log line: “Running without external plugins (—pure / PRAISONAI_NO_PLUGINS)”.

Configuration

Three surfaces suppress plugins. A constructor disabled=True wins; otherwise the env var decides.

Surface	Precedence	Persists?	Use when
`PluginManager(disabled=True)`	1 (wins)	No	Embedded Python, one call, deterministic
`--pure` / `--no-plugins` CLI flag	2	No — scoped, auto-restored	One CLI invocation
`PRAISONAI_NO_PLUGINS=1` env var	3	Only for the shell	Whole CI job / shell session
(none) — default	4	—	Normal use (backward-compatible)

The env var accepts true, 1, or yes (case-insensitive). Pure Mode never mutates .praisonai/config.yaml or any persisted enable/disable state. Python parity forces suppression regardless of the env var:

from praisonaiagents.plugins import PluginManager

manager = PluginManager(disabled=True)
manager.discover_entry_points()   # returns 0; no plugins loaded

Common Patterns

Reproduce a CI failure without whatever plugin your machine has enabled:

praisonai run --pure "Reproduce the failing task"

Debug a plugin regression by comparing a normal run with a plugin-free one:

praisonai chat --no-plugins

Reuse in a notebook — one cell runs pure, the next picks plugins back up automatically:

from praisonai_code.cli.commands.run import run_main

run_main(pure=True)   # this call: no plugins
run_main()            # next call: plugins restored automatically

Best Practices

Use --pure for bug reports

Attach the plugin-free reproduction alongside the normal one — it makes obvious whether a plugin is involved.

Prefer the CLI flag over the env var for one-offs

The flag’s scope is guaranteed — it always restores the prior value on return.

Keep PRAISONAI_NO_PLUGINS out of your shell rc

A persistent export defeats the one-shot contract and hides real plugin behaviour from every command.

Check plugins doctor to see which mode you're in

praisonai plugins doctor tells you whether plugins are suppressed for the current process.

Plugins CLI

List, enable, disable, and diagnose plugins

Plugins

Write, load, and configure plugins

Getting Started

Install

Core Concepts

Guides

Features

Models

Databases

Observability

Memory

Telemetry & Analytics

Knowledge

RAG

Persistence

Tools

Other Features

Developers

Configuration

Best Practices

Getting Started (No Code)

Pure Mode (Suppress Plugins)

Quick Start

How It Works

Configuration

Common Patterns

Best Practices

Plugins CLI

Plugins

​Quick Start

​How It Works

​Configuration

​Common Patterns

​Best Practices

​Related

Plugins CLI

Plugins

Quick Start

How It Works

Configuration

Common Patterns

Best Practices

Related