paths • AI Agent SDK

Centralized Path Utilities for PraisonAI Agents.

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_dir

Get 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

from praisonaiagents import paths

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'