Pure Mode (Suppress Plugins)

Skip plugin discovery for a single run — clean, deterministic baseline

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

Quick Start

1. Use the CLI flag

   praisonai run --pure "Summarise this file"

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

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

Related