Documentation Inconsistency: .env File Location

[hjbrandt]

Description:
The documentation is inconsistent about where to place the .env file for the voice server configuration.

Current Documentation:

• README.md states: "Add your ElevenLabs API key to ~/.env"
• QUICKSTART.md states: "The ~/.env file should be in your home directory, NOT in the PAI directory"

Suggested Fix:

• Clarify in all documentation files whether .env should be placed in:
  • ~/.env (home directory), or
  • ./.claude/.env (PAI directory)
• Update the voice server code to explicitly document which location it reads from

[danielmiessler]

✅ Fixed by Kai

Added clarification to resolve the confusion about .env file locations.

The Answer: PAI uses TWO separate .env files for different purposes:

1. ${PAI_DIR}/.env (typically ~/.claude/.env) - Main PAI configuration

   • Contains all API keys (OpenAI, Anthropic, Gemini, etc.)
   • Used by PAI core functionality

2. ~/.env (home directory) - Voice server configuration

   • Contains only ElevenLabs API key
   • Used by the voice server service

Why two files? The voice server runs as a standalone system service and needs its config in a standard location (~/.env), while PAI main config lives in the PAI directory for portability.

Changes Made:

• Updated README.md to clarify this distinction
• Added note in the environment setup section
• Voice server docs remain correct (they properly reference ~/.env)

This is intentional architecture, not an inconsistency.

[danielmiessler]

📢 Update: Major Skills & Commands Refresh

We've completed a comprehensive update of the research skill and command system to ensure everything works correctly with the new directory structure:

✅ Research Skill - Completely rewritten with 3-mode system (Quick/Standard/Extensive)
✅ Conduct-Research Command - Full workflow documentation added
✅ All Paths - Updated to use ${PAI_DIR}/.claude/ format
✅ Environment Setup - Clarified dual .env locations with full documentation

The .env configuration is now fully documented and all skills reference the correct locations.

[bnkath2o]

The .env.example file still contains the ElevenLabs block:

============================================================================

TEXT-TO-SPEECH CONFIGURATION

============================================================================

ElevenLabs (for premium voice synthesis)

Get your key from: https://elevenlabs.io/app/settings/api-keys

ELEVENLABS_API_KEY=your_elevenlabs_api_key_here

ElevenLabs Voice ID (for TTS voice selection)

Find voice IDs at: https://elevenlabs.io/app/voice-library

Example IDs: "21m00Tcm4TlvDq8ikWAM" (Rachel), "EXAVITQu4vr4xnSDxMaL" (Bella)

ELEVENLABS_VOICE_ID=your_elevenlabs_voice_id_here

Voice Server port is also defined, is this required, or left over from the restructuring of PAI?

============================================================================

VOICE SERVER CONFIGURATION

============================================================================

PORT=8888

[danielmiessler]

This is because I moved back to Eleven Labs because the Apple voices were so bad. : (

…

On Tue, Oct 28, 2025 at 6:56 PM, bnkath2o < ***@***.*** > wrote: *bnkath2o* left a comment (danielmiessler/ Personal_AI_Infrastructure#55) ( #55 (comment) ) The .env.example file still contains the ElevenLabs block: **************************************************************************** ============================================================================ **************************************************************************** **************************** TEXT-TO-SPEECH CONFIGURATION **************************** **************************************************************************** ============================================================================ **************************************************************************** **************************************** ElevenLabs (for premium voice synthesis) **************************************** ******************************************************************************************************************** Get your key from: https:/ / elevenlabs. io/ app/ settings/ api-keys ( https://elevenlabs.io/app/settings/api-keys ) ******************************************************************************************************************** ELEVENLABS_API_KEY=your_elevenlabs_api_key_here ********************************************* ElevenLabs Voice ID (for TTS voice selection) ********************************************* *********************************************************************************************************** Find voice IDs at: https:/ / elevenlabs. io/ app/ voice-library ( https://elevenlabs.io/app/voice-library ) *********************************************************************************************************** **************************************************************************** Example IDs: "21m00Tcm4TlvDq8ikWAM" (Rachel), "EXAVITQu4vr4xnSDxMaL" (Bella) **************************************************************************** ELEVENLABS_VOICE_ID=your_elevenlabs_voice_id_here Voice Server port is also defined, is this required, or left over from the restructuring of PAI? **************************************************************************** ============================================================================ **************************************************************************** ************************** VOICE SERVER CONFIGURATION ************************** **************************************************************************** ============================================================================ **************************************************************************** PORT=8888 — Reply to this email directly, view it on GitHub ( #55 (comment) ) , or unsubscribe ( https://github.com/notifications/unsubscribe-auth/AAAMLXVSDBDD6LJNF4BIYVL3Z6U4BAVCNFSM6AAAAACJ4ER6I6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTINJXG43TONZQG4 ). You are receiving this because you modified the open/close state. Message ID: <danielmiessler/Personal_AI_Infrastructure/issues/55/3457777707 @ github . com>

[bnkath2o]

That I understand. My comment was directed at the ElevenLabs API keys being in two locations, the .env file for the voice server, and in the main .env file if a user were to use .env.example as a template for the .env file.

Really appreciate you sharing PAI with us!!!