Improve .env File Organization, Readability, and Documentation

This pull request aims to enhance the organization, readability, and understanding of the .env.template file for users when they modify the settings. The changes include organizing the file in a tree-like structure with appropriate comments, providing clear guidance for users about the purpose of each variable, their possible values, and default settings when applicable.

As a user with no prior knowledge of best practices of contributing to a project / .env.template file documentation, I took the liberty to make changes to the file based on what I would have liked to have seen when I first encountered it. My goal was to include every configurable option for ease of use and better understanding of how the code works.

The key improvements made in this pull request are:

1. Grouping related variables under appropriate headers for better organization and ease of navigation.
2. Adding informative comments for each variable to help users understand their purpose and possible values.
3. Including default values in the comments to inform users of the consequences of not providing a specific value for a variable, allowing them to make 
    informed decisions when configuring the application.
4. Formatting the file consistently for better readability.

These changes will enhance user experience by simplifying the configuration process and reducing potential confusion. Users can quickly and easily configure the application without having to search through the code to determine default values or understand the relationship between various settings. Additionally, well-organized code and documentation can lead to fewer issues and misunderstandings, saving time for both users and maintainers of the project.

Please review these changes and let me know if you have any questions or suggestions for further improvement so I can make any necessary adjustments.
pull/980/head
lekapsy 2023-04-12 18:54:10 +02:00 committed by GitHub
parent a7176cd229
commit d237cf3d87
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 89 additions and 9 deletions

View File

@ -1,17 +1,97 @@
PINECONE_API_KEY=your-pinecone-api-key ################################################################################
PINECONE_ENV=your-pinecone-region ### LLM PROVIDER
################################################################################
### OPENAI
# OPENAI_API_KEY - OpenAI API Key (Example: my-openai-api-key)
OPENAI_API_KEY=your-openai-api-key OPENAI_API_KEY=your-openai-api-key
ELEVENLABS_API_KEY=your-elevenlabs-api-key
ELEVENLABS_VOICE_1_ID=your-voice-id # Use Azure OpenAI
ELEVENLABS_VOICE_2_ID=your-voice-id # USE_AZURE - Use Azure OpenAI or not (Default: False)
SMART_LLM_MODEL=gpt-4
FAST_LLM_MODEL=gpt-3.5-turbo
GOOGLE_API_KEY=
CUSTOM_SEARCH_ENGINE_ID=
USE_AZURE=False USE_AZURE=False
### AZURE OPENAI
# OPENAI_AZURE_API_BASE - OpenAI API base URL for Azure (Example: https://my-azure-openai-url.com)
OPENAI_AZURE_API_BASE=your-base-url-for-azure OPENAI_AZURE_API_BASE=your-base-url-for-azure
# OPENAI_AZURE_API_VERSION - OpenAI API version for Azure (Example: v1)
OPENAI_AZURE_API_VERSION=api-version-for-azure OPENAI_AZURE_API_VERSION=api-version-for-azure
# OPENAI_AZURE_DEPLOYMENT_ID - OpenAI deployment ID for Azure (Example: my-deployment-id)
OPENAI_AZURE_DEPLOYMENT_ID=deployment-id-for-azure OPENAI_AZURE_DEPLOYMENT_ID=deployment-id-for-azure
################################################################################
### LLM MODELS
################################################################################
# SMART_LLM_MODEL - Smart language model (Default: gpt-4)
SMART_LLM_MODEL=gpt-4
# FAST_LLM_MODEL - Fast language model (Default: gpt-3.5-turbo)
FAST_LLM_MODEL=gpt-3.5-turbo
### LLM MODEL SETTINGS
# FAST_TOKEN_LIMIT - Fast token limit for OpenAI (Default: 4000)
FAST_TOKEN_LIMIT=4000
# SMART_TOKEN_LIMIT - Smart token limit for OpenAI (Default: 8000)
# When using --gpt3only this needs to be set to 4000.
SMART_TOKEN_LIMIT=8000
################################################################################
### MEMORY
################################################################################
# MEMORY_BACKEND - Memory backend type (Default: local)
MEMORY_BACKEND=redis
### PINECONE
# PINECONE_API_KEY - Pinecone API Key (Example: my-pinecone-api-key)
PINECONE_API_KEY=your-pinecone-api-key
# PINECONE_ENV - Pinecone environment (region) (Example: us-west-2)
PINECONE_ENV=your-pinecone-region
### REDIS
# REDIS_HOST - Redis host (Default: localhost)
REDIS_HOST=localhost
# REDIS_PORT - Redis port (Default: 6379)
REDIS_PORT=6379
# REDIS_PASSWORD - Redis password (Default: "")
REDIS_PASSWORD=
################################################################################
### IMAGE GENERATION PROVIDER
################################################################################
### OPEN AI
# IMAGE_PROVIDER - Image provider (Example: dalle)
IMAGE_PROVIDER=dalle IMAGE_PROVIDER=dalle
### HUGGINGFACE
# STABLE DIFFUSION(
# Default URL: https://api-inference.huggingface.co/models/CompVis/stable-diffusion-v1-4
# Set in image_gen.py)
# HUGGINGFACE_API_TOKEN - HuggingFace API token (Example: my-huggingface-api-token)
HUGGINGFACE_API_TOKEN= HUGGINGFACE_API_TOKEN=
################################################################################
### SEARCH PROVIDER
################################################################################
### GOOGLE
# GOOGLE_API_KEY - Google API key (Example: my-google-api-key)
GOOGLE_API_KEY=
# CUSTOM_SEARCH_ENGINE_ID - Custom search engine ID (Example: my-custom-search-engine-id)
CUSTOM_SEARCH_ENGINE_ID=
################################################################################
### TTS PROVIDER
################################################################################
### MAC OS
# USE_MAC_OS_TTS - Use Mac OS TTS or not (Default: False)
USE_MAC_OS_TTS=False USE_MAC_OS_TTS=False
### ELEVENLABS
# ELEVENLABS_API_KEY - Eleven Labs API key (Example: my-elevenlabs-api-key)
ELEVENLABS_API_KEY=your-elevenlabs-api-key
# ELEVENLABS_VOICE_1_ID - Eleven Labs voice 1 ID (Example: my-voice-id-1)
ELEVENLABS_VOICE_1_ID=your-voice-id
# ELEVENLABS_VOICE_2_ID - Eleven Labs voice 2 ID (Example: my-voice-id-2)
ELEVENLABS_VOICE_2_ID=your-voice-id