Lazy Imports CLI

CLI commands for verifying lazy import behavior

Lazy Imports CLI

Commands for verifying and testing lazy import behavior in PraisonAI Agents.

Commands

Check Lazy Imports

Verify that heavy dependencies are not loaded at import time:

bash
praisonai perf lazy-check

Output:

Lazy Import Check:
  litellm: LAZY (good)
  chromadb: LAZY (good)
  mem0: LAZY (good)
  requests: LAZY (good)

Measure Import Time

Measure the import time of praisonaiagents:

bash
praisonai perf import-time

Output:

Import time: 18.4ms (median)
Target: <200ms
Status: PASS

Full Performance Benchmark

Run a complete performance benchmark including lazy import checks:

bash
praisonai perf benchmark

Output:

============================================================
PraisonAI Agents Performance Benchmark
============================================================

[1/3] Measuring import time...
      Median: 18.4ms [PASS]

[2/3] Measuring memory usage...
      Current: 33.0MB [WARN]

[3/3] Checking lazy imports...
      All lazy: True [PASS]
        ✓ litellm
        ✓ chromadb
        ✓ mem0
        ✓ requests

============================================================
Overall: [PASS]
============================================================

Performance Targets

MetricTargetHard Fail
Import Timeless than 200msgreater than 300ms
Memory Usageless than 30MBgreater than 45MB
Lazy ImportsAll lazyAny eager

Environment Variables

Control lazy import behavior:

bash
# Check current configuration
python -c "from praisonaiagents._config import LAZY_IMPORTS; print(LAZY_IMPORTS)"

CI/CD Integration

Use the check command in CI pipelines:

bash
# Returns exit code 0 on pass, 1 on fail
praisonai perf check

# Use in CI
if praisonai perf check; then
    echo "Performance check passed"
else
    echo "Performance regression detected"
    exit 1
fi

Related