Skip to main content

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:
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:
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:
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:
# Check current configuration
python -c "from praisonaiagents._config import LAZY_IMPORTS; print(LAZY_IMPORTS)"

CI/CD Integration

Use the check command in CI pipelines:
# 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