> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# paths • AI Agent SDK

> Centralized Path Utilities for PraisonAI Agents.

# paths

<Badge color="blue">AI Agent</Badge>

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

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import paths
```

## Functions

<CardGroup cols={2}>
  <Card title="get_data_dir()" icon="function" href="../functions/get_data_dir">
    Get PraisonAI data directory.
  </Card>

  <Card title="get_sessions_dir()" icon="function" href="../functions/get_sessions_dir">
    Get sessions directory.
  </Card>

  <Card title="get_skills_dir()" icon="function" href="../functions/get_skills_dir">
    Get user skills directory.
  </Card>

  <Card title="get_plugins_dir()" icon="function" href="../functions/get_plugins_dir">
    Get user plugins directory.
  </Card>

  <Card title="get_mcp_dir()" icon="function" href="../functions/get_mcp_dir">
    Get MCP config directory.
  </Card>

  <Card title="get_docs_dir()" icon="function" href="../functions/get_docs_dir">
    Get docs directory.
  </Card>

  <Card title="get_rules_dir()" icon="function" href="../functions/get_rules_dir">
    Get rules directory.
  </Card>

  <Card title="get_permissions_dir()" icon="function" href="../functions/get_permissions_dir">
    Get permissions directory.
  </Card>

  <Card title="get_storage_dir()" icon="function" href="../functions/get_storage_dir">
    Get generic storage directory.
  </Card>

  <Card title="get_checkpoints_dir()" icon="function" href="../functions/get_checkpoints_dir">
    Get checkpoints directory.
  </Card>

  <Card title="get_snapshots_dir()" icon="function" href="../functions/get_snapshots_dir">
    Get snapshots directory.
  </Card>

  <Card title="get_learn_dir()" icon="function" href="../functions/get_learn_dir">
    Get learn directory for learning stores.
  </Card>

  <Card title="get_cache_dir()" icon="function" href="../functions/get_cache_dir">
    Get cache directory (disposable data).
  </Card>

  <Card title="get_mcp_auth_path()" icon="function" href="../functions/get_mcp_auth_path">
    Get path to MCP auth storage file.
  </Card>

  <Card title="get_memory_dir()" icon="function" href="../functions/get_memory_dir">
    Get memory directory for short/long term databases.
  </Card>

  <Card title="get_workflows_dir()" icon="function" href="../functions/get_workflows_dir">
    Get workflows directory.
  </Card>

  <Card title="get_summaries_dir()" icon="function" href="../functions/get_summaries_dir">
    Get summaries directory for RAG.
  </Card>

  <Card title="get_prp_dir()" icon="function" href="../functions/get_prp_dir">
    Get PRP (Prompt Response Pair) output directory.
  </Card>

  <Card title="get_runs_dir()" icon="function" href="../functions/get_runs_dir">
    Get runs directory for artifacts.
  </Card>

  <Card title="get_project_data_dir()" icon="function" href="../functions/get_project_data_dir">
    Get project-level data directory.
  </Card>

  <Card title="ensure_dir()" icon="function" href="../functions/ensure_dir">
    Ensure a directory exists, creating it if necessary.
  </Card>

  <Card title="get_all_paths()" icon="function" href="../functions/get_all_paths">
    Get all PraisonAI data paths.
  </Card>
</CardGroup>

### Constants

| Name               | Value              |
| ------------------ | ------------------ |
| `ENV_VAR`          | `'PRAISONAI_HOME'` |
| `DEFAULT_DIR_NAME` | `'.praisonai'`     |
| `LEGACY_DIR_NAME`  | `'.praison'`       |