env.example

# Eliza 3D Agent Framework - Environment Configuration
# Copy this file to .env and fill in your values

# ===== REQUIRED =====
# OpenAI API Key (required for AI responses)
OPENAI_API_KEY=your_openai_api_key_here

# ===== HYPERFY AUTHENTICATION =====
# Optional: Manual JWT token override (leave empty for auto-generation)
HYPERFY_AUTH_TOKEN=

# Hyperfy world WebSocket URL
HYPERFY_WORLD_URL=wss://chill.hyperfy.xyz/ws

# ===== AGENT CONFIGURATION =====
# Agent name (appears in Hyperfy)
AGENT_NAME=Eliza

# Enable debug mode for detailed logging
DEBUG_MODE=false

# ===== ADVANCED SETTINGS =====
# JWT signing secret (for token generation)
HYPERFY_JWT_SECRET=hyperfy-default-secret

# Token expiry time in hours (default: 168 = 7 days)
HYPERFY_TOKEN_EXPIRY_HOURS=168

# File to store generated tokens
HYPERFY_TOKEN_FILE=hyperfy_token.json

# Connection settings
HYPERFY_RECONNECT_ATTEMPTS=5
HYPERFY_HEARTBEAT_INTERVAL=30

# ===== OPTIONAL FEATURES =====
# Enable/disable voice recognition and synthesis
VOICE_ENABLED=true

# Enable/disable LangChain AI features
LANGCHAIN_ENABLED=true

# Enable/disable physics simulation
PHYSICS_ENABLED=true

# =============================================================================
# AI PROVIDER API KEYS
# =============================================================================

# Anthropic API Key (for Claude models)
ANTHROPIC_API_KEY=your_anthropic_api_key_here

# Google API Key (for speech recognition and other Google services)
GOOGLE_API_KEY=your_google_api_key_here

# Azure Speech Services (for voice capabilities)
AZURE_SPEECH_KEY=your_azure_speech_key_here
AZURE_SPEECH_REGION=your_azure_region_here

# =============================================================================
# HYPERFY WORLD CONNECTION
# =============================================================================

# Agent Name in Hyperfy
HYPERFY_AGENT_NAME=MyAgent

# =============================================================================
# VOICE CONFIGURATION
# =============================================================================

# Enable voice capabilities (true/false)
ENABLE_VOICE=false

# Voice recognition engine (google, sphinx, mock)
VOICE_RECOGNITION_ENGINE=mock

# Text-to-speech engine (pyttsx3, azure, google, openai, mock)
VOICE_TTS_ENGINE=mock

# Voice confidence threshold (0.0-1.0)
VOICE_CONFIDENCE_THRESHOLD=0.7

# Voice language code
VOICE_LANGUAGE=en-US

# =============================================================================
# AI CONFIGURATION
# =============================================================================

# Primary AI provider (openai, anthropic, langchain, mock)
AI_PROVIDER=mock

# Fallback AI provider (optional)
AI_FALLBACK_PROVIDER=

# AI temperature (0.0-2.0)
AI_TEMPERATURE=0.7

# Maximum tokens per AI response
AI_MAX_TOKENS=150

# Enable LangChain integration (true/false)
USE_LANGCHAIN=false

# =============================================================================
# PHYSICS AND WORLD SETTINGS
# =============================================================================

# Enable physics simulation (true/false)
ENABLE_PHYSICS=false

# Physics gravity
PHYSICS_GRAVITY=-9.81

# Default movement speed
MOVEMENT_SPEED=1.0

# =============================================================================
# LOGGING CONFIGURATION
# =============================================================================

# Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
LOG_LEVEL=INFO

# Log to file (true/false)
LOG_TO_FILE=true

# Log file path
LOG_FILE=eliza_agent.log

# =============================================================================
# AGENT BEHAVIOR
# =============================================================================

# Agent unique identifier
AGENT_ID=my_agent_1

# Debug mode (true/false)
DEBUG=false

# Enable proactive behavior (true/false)
ENABLE_PROACTIVE_BEHAVIOR=true

# Agent update frequency (Hz)
UPDATE_FREQUENCY=60.0

# =============================================================================
# CHARACTER PERSONALITY
# =============================================================================

# Character name
CHARACTER_NAME=MyAgent

# Character personality traits
CHARACTER_PERSONALITY=friendly, helpful, curious

# Greeting cooldown in seconds
GREETING_COOLDOWN=300.0

# =============================================================================
# DEVELOPMENT/TESTING SETTINGS
# =============================================================================

# Dry run mode - simulates connections without actually connecting (true/false)
DRY_RUN=false

# Enable emote system (true/false)
ENABLE_EMOTES=true

# =============================================================================
# EXAMPLE CONFIGURATIONS
# =============================================================================

# For development with mocked services:
# AI_PROVIDER=mock
# VOICE_RECOGNITION_ENGINE=mock
# VOICE_TTS_ENGINE=mock
# ENABLE_PHYSICS=false
# DRY_RUN=true

# For production with OpenAI:
# AI_PROVIDER=openai
# OPENAI_API_KEY=sk-your-actual-openai-key
# VOICE_RECOGNITION_ENGINE=google
# VOICE_TTS_ENGINE=openai
# ENABLE_PHYSICS=true
# DRY_RUN=false

# For Alice-like character:
# CHARACTER_NAME=Alice
# CHARACTER_PERSONALITY=curious, whimsical, philosophical, wonder-filled
# AI_PROVIDER=anthropic
# ANTHROPIC_API_KEY=your-anthropic-key