Files
Benjamin Taylor c8736df6f0 docs(examples): warn that the Intelligence URL vars in .env.example are local-only
Every starter's .env.example documents INTELLIGENCE_API_URL and
INTELLIGENCE_GATEWAY_WS_URL under its Threads-enablement block, with a
localhost/local-ws value. Uncommenting (or, in llamaindex/mcp-apps,
leaving as shipped) that block is the documented way to enable Threads,
but it silently points the channel host at a local Intelligence that is
usually not running — so `ready()` burns its 30s timeout and the host
exits 1 with no indication why.

Adds a short comment next to those two vars in each of the 14 starters
that ship an .env.example (mastra has none tracked in this branch) noting
they're for a self-hosted or local Intelligence deployment only and
should be left unset for managed Intelligence. No values changed, nothing
uncommented.
2026-08-02 01:18:13 -05:00

56 lines
1.6 KiB
Bash

# ========================================
# API Keys (REQUIRED)
# ========================================
# Google API Key (for ADK agents: Orchestrator, Analysis)
# Get your key from: https://aistudio.google.com/app/apikey
GOOGLE_API_KEY=your_google_api_key_here
# OpenAI API Key (for LangGraph agents: Research)
# Get your key from: https://platform.openai.com/api-keys
OPENAI_API_KEY=your_openai_api_key_here
# ========================================
# Agent URLs (Frontend → Agents)
# Optional - these are the defaults
# ========================================
# Orchestrator (ADK + AG-UI Protocol)
ORCHESTRATOR_URL=http://localhost:9000
# Research Agent (LangGraph + A2A Protocol)
RESEARCH_AGENT_URL=http://localhost:9001
# Analysis Agent (ADK + A2A Protocol)
ANALYSIS_AGENT_URL=http://localhost:9002
# ========================================
# Agent Ports (Python Agents)
# Optional - used by Python agents to bind to specific ports
# ========================================
# Orchestrator
ORCHESTRATOR_PORT=9000
# Research Agent
RESEARCH_PORT=9001
# Analysis Agent
ANALYSIS_PORT=9002
# ========================================
# CopilotKit Intelligence Threads (Optional)
# ========================================
# COPILOTKIT_LICENSE_TOKEN=
# INTELLIGENCE_API_KEY=
# INTELLIGENCE_API_URL and INTELLIGENCE_GATEWAY_WS_URL point at a self-hosted
# or local Intelligence deployment only — leave them unset when using managed
# Intelligence, or the channel host and runtime will try to reach a local
# stack that usually is not running.
# INTELLIGENCE_API_URL=http://localhost:4201
# INTELLIGENCE_GATEWAY_WS_URL=ws://localhost:4401