horde-model-reference/.env.primary.example at main · Haidra-Org/horde-model-reference · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# Example environment configuration for PRIMARY mode deployment
# Copy this to .env.primary and configure as needed

# ============================================================================
# PRIMARY Mode Configuration
# ============================================================================

# REQUIRED: Set to PRIMARY mode
HORDE_MODEL_REFERENCE_REPLICATE_MODE=PRIMARY

# Create folders automatically if they don't exist
HORDE_MODEL_REFERENCE_MAKE_FOLDERS=true

# Cache TTL in seconds (default: 60)
HORDE_MODEL_REFERENCE_CACHE_TTL_SECONDS=60

# ============================================================================
# Data Format Configuration
# ============================================================================

# Which format is canonical (controls which API has write access)
# - 'legacy': v1 API has CRUD, v2 API is read-only (converts from legacy to v2)
# - 'v2': v2 API has CRUD, v1 API is read-only (converts from v2 to legacy)
# Default is 'v2' but set to 'legacy' during transition period
HORDE_MODEL_REFERENCE_CANONICAL_FORMAT=LEGACY

# ============================================================================
# GitHub Seeding (First-Time Setup)
# ============================================================================

# Enable GitHub seeding on first startup if local files don't exist
# Set to 'true' for initial deployment, then change to 'false'
HORDE_MODEL_REFERENCE_GITHUB_SEED_ENABLED=false

# ============================================================================
# Redis Configuration (Multi-Worker Deployments Only)
# ============================================================================

# Enable Redis for distributed caching (required for multi-worker setups)
# HORDE_MODEL_REFERENCE_REDIS__USE_REDIS=true

# Redis connection URL
# HORDE_MODEL_REFERENCE_REDIS__URL=redis://redis:6379/0

# Redis connection pool size
# HORDE_MODEL_REFERENCE_REDIS__POOL_SIZE=10

# Redis TTL (uses cache_ttl_seconds if not specified)
# HORDE_MODEL_REFERENCE_REDIS__TTL_SECONDS=60

# Enable pub/sub for cache invalidation across workers
# HORDE_MODEL_REFERENCE_REDIS__USE_PUBSUB=true

# ============================================================================
# Data Directory
# ============================================================================

# Cache home directory (set by Docker, but can be overridden)
# AIWORKER_CACHE_HOME=/data

# ============================================================================
# Optional: GitHub Repository Overrides (for testing/forks)
# ============================================================================

# Override default GitHub repositories (uncomment to use)
# HORDE_MODEL_REFERENCE_IMAGE_GITHUB_REPO_OWNER=Haidra-Org
# HORDE_MODEL_REFERENCE_IMAGE_GITHUB_REPO_NAME=AI-Horde-image-model-reference
# HORDE_MODEL_REFERENCE_IMAGE_GITHUB_REPO_BRANCH=main

# HORDE_MODEL_REFERENCE_TEXT_GITHUB_REPO_OWNER=Haidra-Org
# HORDE_MODEL_REFERENCE_TEXT_GITHUB_REPO_NAME=AI-Horde-text-model-reference
# HORDE_MODEL_REFERENCE_TEXT_GITHUB_REPO_BRANCH=main