paths
AI Agent Centralized Path Utilities for PraisonAI Agents. All persistent data uses ~/.praisonai/ by default. Override with PRAISONAI_HOME environment variable. This module provides a single source of truth for all data storage paths, eliminating hardcoded paths throughout the codebase (DRY principle). Usage: from praisonaiagents.paths import get_data_dir, get_sessions_dirGet user data directory
data_dir = get_data_dir() # ~/.praisonai/Get specific subdirectories
sessions_dir = get_sessions_dir() # ~/.praisonai/sessions/Override with environment variable
export PRAISONAI_HOME=/custom/path
data_dir = get_data_dir() # /custom/path/
Backward Compatibility: If ~/.praisonai/ doesn’t exist but ~/.praison/ does, the legacy path will be used with a deprecation warning. Run ‘praisonai migrate-data’ to migrate to the new location.Import
Functions
get_data_dir()
Get PraisonAI data directory.
get_sessions_dir()
Get sessions directory.
get_skills_dir()
Get user skills directory.
get_plugins_dir()
Get user plugins directory.
get_mcp_dir()
Get MCP config directory.
get_docs_dir()
Get docs directory.
get_rules_dir()
Get rules directory.
get_permissions_dir()
Get permissions directory.
get_storage_dir()
Get generic storage directory.
get_checkpoints_dir()
Get checkpoints directory.
get_snapshots_dir()
Get snapshots directory.
get_learn_dir()
Get learn directory for learning stores.
get_cache_dir()
Get cache directory (disposable data).
get_mcp_auth_path()
Get path to MCP auth storage file.
get_memory_dir()
Get memory directory for short/long term databases.
get_workflows_dir()
Get workflows directory.
get_summaries_dir()
Get summaries directory for RAG.
get_prp_dir()
Get PRP (Prompt Response Pair) output directory.
get_runs_dir()
Get runs directory for artifacts.
get_project_data_dir()
Get project-level data directory.
ensure_dir()
Ensure a directory exists, creating it if necessary.
get_all_paths()
Get all PraisonAI data paths.
Constants
| Name | Value |
|---|---|
ENV_VAR | 'PRAISONAI_HOME' |
DEFAULT_DIR_NAME | '.praisonai' |
LEGACY_DIR_NAME | '.praison' |