Add Docker image test script, fix stale API key env vars, rewrite DOC…

.env.example

@@ -1,36 +1,86 @@
-# llms-py Environment Variables
-# Copy this file to .env and fill in your API keys
+# llms-py API keys
+#
+# Copy to .env and fill in the providers you have keys for:  cp .env.example .env
+# One VAR=value per line, no quotes, no spaces around '='.
+#
+# Or let the installer generate ~/.llms/.env for you:
+#   curl -fsSL https://llmspy.org/install.sh | bash
+#
+# Providers with no key set are skipped at startup.
 
-# OpenRouter (Free tier available)
-OPENROUTER_API_KEY=
+# Alibaba  —  https://www.alibabacloud.com/help/en/model-studio/models
+DASHSCOPE_API_KEY=
 
-# Groq (Free tier available)
-GROQ_API_KEY=
+# Anthropic  —  https://docs.anthropic.com/en/docs/about-claude/models
+ANTHROPIC_API_KEY=
+
+# Cerebras  —  https://inference-docs.cerebras.ai/models/overview
+CEREBRAS_API_KEY=
 
-# Google Free API (Free tier available)
-GOOGLE_FREE_API_KEY=
+# Chutes  —  https://llm.chutes.ai/v1/models
+CHUTES_API_KEY=
 
-# Codestral (Free tier available)
+# codestral
 CODESTRAL_API_KEY=
 
-# Google Gemini API
+# DeepSeek  —  https://api-docs.deepseek.com/quick_start/pricing
+DEEPSEEK_API_KEY=
+
+# Fireworks AI  —  https://fireworks.ai/docs/
+FIREWORKS_API_KEY=
+
+# GitHub Copilot  —  https://docs.github.com/en/copilot
+GITHUB_TOKEN=
+
+# Google  —  https://ai.google.dev/gemini-api/docs/models
 GOOGLE_API_KEY=
+# GOOGLE_GENERATIVE_AI_API_KEY=
+# GEMINI_API_KEY=
 
-# Anthropic Claude API
-ANTHROPIC_API_KEY=
+# Groq  —  https://console.groq.com/docs/models
+GROQ_API_KEY=
+
+# Hugging Face  —  https://huggingface.co/docs/inference-providers
+HF_TOKEN=
+
+# llmspy
+LLMSPY_API_KEY=
 
-# OpenAI API
+# MiniMax (minimax.io)  —  https://platform.minimax.io/docs/guides/quickstart
+MINIMAX_API_KEY=
+
+# Mistral  —  https://docs.mistral.ai/getting-started/models/
+MISTRAL_API_KEY=
+
+# Moonshot AI  —  https://platform.moonshot.ai/docs/api/chat
+MOONSHOT_API_KEY=
+
+# Nvidia  —  https://docs.api.nvidia.com/nim/
+NVIDIA_API_KEY=
+
+# Ollama Cloud  —  https://docs.ollama.com/cloud
+OLLAMA_API_KEY=
+
+# OpenAI  —  https://platform.openai.com/docs/models
 OPENAI_API_KEY=
 
-# Grok (X.AI) API
-GROK_API_KEY=
+# OpenRouter  —  https://openrouter.ai/models
+OPENROUTER_API_KEY=
 
-# Qwen (Alibaba DashScope) API
-DASHSCOPE_API_KEY=
+# xAI  —  https://docs.x.ai/docs/models
+XAI_API_KEY=
 
-# Z.ai API
-ZAI_API_KEY=
+# Z.AI / Z.AI Coding Plan  —  https://docs.z.ai/guides/overview/pricing
+ZHIPU_API_KEY=
 
-# Mistral API
-MISTRAL_API_KEY=
 
+# ---------------------------------------------------------------------------
+# Local providers — no key needed unless you've set one.
+# From Docker, point them at host.docker.internal instead of localhost.
+# ---------------------------------------------------------------------------
+
+# LMStudio  —  https://lmstudio.ai/models
+LMSTUDIO_API_KEY=
+
+# openai-local
+OPENAI_LOCAL_API_KEY=