.env.example

# =============================================================================
# PowerMem TS Configuration Template
# =============================================================================
# Copy this file to .env and adjust the values you need.
# The variable names below follow the Python powermem naming scheme.
# =============================================================================

# -----------------------------------------------------------------------------
# Timezone
# -----------------------------------------------------------------------------
TIMEZONE=Asia/Shanghai

# -----------------------------------------------------------------------------
# 1. Database Configuration
# -----------------------------------------------------------------------------
# Supported providers in TS:
#   sqlite
#   oceanbase (embedded mode only; leave OCEANBASE_HOST empty and use OCEANBASE_PATH)
#   pgvector / postgres
DATABASE_PROVIDER=sqlite

# SQLite
SQLITE_PATH=./data/powermem_dev.db
SQLITE_ENABLE_WAL=true
SQLITE_TIMEOUT=30
SQLITE_COLLECTION=memories

# OceanBase / embedded SeekDB mode
OCEANBASE_HOST=
OCEANBASE_PATH=./seekdb_data
OCEANBASE_PORT=2881
OCEANBASE_USER=root@test
OCEANBASE_PASSWORD=
OCEANBASE_DATABASE=test
OCEANBASE_COLLECTION=power_mem
OCEANBASE_INDEX_TYPE=HNSW
OCEANBASE_VECTOR_METRIC_TYPE=l2
OCEANBASE_TEXT_FIELD=document
OCEANBASE_VECTOR_FIELD=embedding
OCEANBASE_EMBEDDING_MODEL_DIMS=1536
OCEANBASE_PRIMARY_FIELD=id
OCEANBASE_METADATA_FIELD=metadata
OCEANBASE_VIDX_NAME=vidx

# PostgreSQL / pgvector
POSTGRES_HOST=127.0.0.1
POSTGRES_PORT=5432
POSTGRES_USER=postgres
POSTGRES_PASSWORD=
POSTGRES_DATABASE=postgres
POSTGRES_COLLECTION=power_mem
POSTGRES_EMBEDDING_MODEL_DIMS=1536
POSTGRES_DISKANN=false
POSTGRES_HNSW=true
# VECTOR_STORE_CONNECTION_STRING=
# DATABASE_SSLMODE=prefer

# -----------------------------------------------------------------------------
# 2. LLM Configuration
# -----------------------------------------------------------------------------
# Common providers in TS:
#   qwen, openai, siliconflow, deepseek, anthropic, ollama, azure_openai
LLM_PROVIDER=qwen
LLM_API_KEY=your_api_key_here
LLM_MODEL=qwen-plus
LLM_TEMPERATURE=0.7
LLM_MAX_TOKENS=1000
LLM_TOP_P=0.8
LLM_TOP_K=50
LLM_ENABLE_SEARCH=false

QWEN_LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
OPENAI_LLM_BASE_URL=https://api.openai.com/v1
SILICONFLOW_LLM_BASE_URL=https://api.siliconflow.cn/v1
DEEPSEEK_LLM_BASE_URL=https://api.deepseek.com
ANTHROPIC_LLM_BASE_URL=https://api.anthropic.com
VLLM_LLM_BASE_URL=
OLLAMA_LLM_BASE_URL=

# Provider-specific aliases accepted by TS config loader
# QWEN_API_KEY=
# DASHSCOPE_API_KEY=
# AZURE_OPENAI_API_KEY=
# AZURE_OPENAI_INSTANCE=
# AZURE_OPENAI_API_VERSION=2024-02-01
# AWS_REGION=us-east-1

# -----------------------------------------------------------------------------
# 3. Embedding Configuration
# -----------------------------------------------------------------------------
EMBEDDING_PROVIDER=qwen
EMBEDDING_API_KEY=your_api_key_here
EMBEDDING_MODEL=text-embedding-v4
EMBEDDING_DIMS=1536

QWEN_EMBEDDING_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
OPENAI_EMBEDDING_BASE_URL=https://api.openai.com/v1
SILICONFLOW_EMBEDDING_BASE_URL=https://api.siliconflow.cn/v1
HUGGINFACE_EMBEDDING_BASE_URL=
LMSTUDIO_EMBEDDING_BASE_URL=
OLLAMA_EMBEDDING_BASE_URL=

# -----------------------------------------------------------------------------
# 4. Reranker Configuration
# -----------------------------------------------------------------------------
RERANKER_ENABLED=false
RERANKER_PROVIDER=qwen
RERANKER_MODEL=qwen3-rerank
RERANKER_API_KEY=
RERANKER_API_BASE_URL=
RERANKER_TOP_N=

# Optional provider-specific aliases
# JINA_API_KEY=
# JINA_API_BASE_URL=
# ZAI_API_KEY=
# ZAI_API_BASE_URL=
# QWEN_RERANK_BASE_URL=
# DASHSCOPE_BASE_URL=

# -----------------------------------------------------------------------------
# 5. Agent Configuration
# -----------------------------------------------------------------------------
AGENT_ENABLED=true
AGENT_MEMORY_MODE=auto
AGENT_DEFAULT_SCOPE=AGENT
AGENT_DEFAULT_PRIVACY_LEVEL=PRIVATE
AGENT_DEFAULT_COLLABORATION_LEVEL=READ_ONLY
AGENT_DEFAULT_ACCESS_PERMISSION=OWNER_ONLY

# -----------------------------------------------------------------------------
# 6. Intelligent Memory Configuration
# -----------------------------------------------------------------------------
INTELLIGENT_MEMORY_ENABLED=true
INTELLIGENT_MEMORY_INITIAL_RETENTION=1.0
INTELLIGENT_MEMORY_DECAY_RATE=0.1
INTELLIGENT_MEMORY_REINFORCEMENT_FACTOR=0.3
INTELLIGENT_MEMORY_WORKING_THRESHOLD=0.3
INTELLIGENT_MEMORY_SHORT_TERM_THRESHOLD=0.6
INTELLIGENT_MEMORY_LONG_TERM_THRESHOLD=0.8
INTELLIGENT_MEMORY_FALLBACK_TO_SIMPLE_ADD=false

MEMORY_DECAY_ENABLED=true
MEMORY_DECAY_ALGORITHM=ebbinghaus
MEMORY_DECAY_BASE_RETENTION=1.0
MEMORY_DECAY_FORGETTING_RATE=0.1
MEMORY_DECAY_REINFORCEMENT_FACTOR=0.3

# -----------------------------------------------------------------------------
# 7. Performance Configuration
# -----------------------------------------------------------------------------
MEMORY_BATCH_SIZE=100
MEMORY_CACHE_SIZE=1000
MEMORY_CACHE_TTL=3600
MEMORY_SEARCH_LIMIT=10
MEMORY_SEARCH_THRESHOLD=0.7
VECTOR_STORE_BATCH_SIZE=50
VECTOR_STORE_CACHE_SIZE=500
VECTOR_STORE_INDEX_REBUILD_INTERVAL=86400

# -----------------------------------------------------------------------------
# 8. Security Configuration
# -----------------------------------------------------------------------------
ENCRYPTION_ENABLED=false
ENCRYPTION_KEY=
ENCRYPTION_ALGORITHM=AES-256-GCM
ACCESS_CONTROL_ENABLED=true
ACCESS_CONTROL_DEFAULT_PERMISSION=READ_ONLY
ACCESS_CONTROL_ADMIN_USERS=admin,root

# -----------------------------------------------------------------------------
# 9. Telemetry Configuration
# -----------------------------------------------------------------------------
TELEMETRY_ENABLED=false
TELEMETRY_ENDPOINT=https://telemetry.powermem.ai
TELEMETRY_API_KEY=
TELEMETRY_BATCH_SIZE=100
TELEMETRY_FLUSH_INTERVAL=30
TELEMETRY_RETENTION_DAYS=30

# -----------------------------------------------------------------------------
# 10. Audit Configuration
# -----------------------------------------------------------------------------
AUDIT_ENABLED=true
AUDIT_LOG_FILE=./logs/audit.log
AUDIT_LOG_LEVEL=INFO
AUDIT_RETENTION_DAYS=90
AUDIT_COMPRESS_LOGS=true
AUDIT_LOG_ROTATION_SIZE=100MB

# -----------------------------------------------------------------------------
# 11. Logging Configuration
# -----------------------------------------------------------------------------
LOGGING_LEVEL=DEBUG
LOGGING_FORMAT=%(asctime)s - %(name)s - %(levelname)s - %(message)s
LOGGING_FILE=./logs/powermem.log
LOGGING_MAX_SIZE=100MB
LOGGING_BACKUP_COUNT=5
LOGGING_COMPRESS_BACKUPS=true
LOGGING_CONSOLE_ENABLED=true
LOGGING_CONSOLE_LEVEL=INFO
LOGGING_CONSOLE_FORMAT=%(levelname)s - %(message)s

# -----------------------------------------------------------------------------
# 12. Graph Store Configuration
# -----------------------------------------------------------------------------
GRAPH_STORE_ENABLED=false
GRAPH_STORE_PROVIDER=oceanbase
GRAPH_STORE_HOST=
GRAPH_STORE_PATH=./seekdb_data
GRAPH_STORE_PORT=2881
GRAPH_STORE_USER=root@test
GRAPH_STORE_PASSWORD=
GRAPH_STORE_DB_NAME=test
GRAPH_STORE_COLLECTION_NAME=power_mem
GRAPH_STORE_EMBEDDING_MODEL_DIMS=1536
GRAPH_STORE_MAX_HOPS=3
GRAPH_STORE_INDEX_TYPE=HNSW
GRAPH_STORE_VECTOR_METRIC_TYPE=l2
# GRAPH_STORE_CUSTOM_PROMPT=
# GRAPH_STORE_CUSTOM_EXTRACT_RELATIONS_PROMPT=
# GRAPH_STORE_CUSTOM_UPDATE_GRAPH_PROMPT=
# GRAPH_STORE_CUSTOM_DELETE_RELATIONS_PROMPT=

# -----------------------------------------------------------------------------
# 13. Sparse Embedding Configuration
# -----------------------------------------------------------------------------
SPARSE_VECTOR_ENABLE=false
SPARSE_EMBEDDER_PROVIDER=
SPARSE_EMBEDDER_API_KEY=
SPARSE_EMBEDDER_MODEL=
SPARSE_EMBEDDING_BASE_URL=
# SPARSE_EMBEDDER_DIMS=

# -----------------------------------------------------------------------------
# 14. Query Rewrite Configuration
# -----------------------------------------------------------------------------
QUERY_REWRITE_ENABLED=false
# QUERY_REWRITE_PROMPT=
# QUERY_REWRITE_MODEL_OVERRIDE=

# -----------------------------------------------------------------------------
# 15. Custom Prompts
# -----------------------------------------------------------------------------
# CUSTOM_FACT_EXTRACTION_PROMPT=
# CUSTOM_UPDATE_MEMORY_PROMPT=
# CUSTOM_IMPORTANCE_EVALUATION_PROMPT=