Skip to content

environment-variables.md

Latest commit

 

History

History
133 lines (98 loc) · 4.11 KB

environment-variables.md

File metadata and controls

133 lines (98 loc) · 4.11 KB

Environment Variables

All configuration variables for IntellyWeave CLI.

Overview

IntellyWeave CLI uses environment variables for configuration. Store them in a .env file in your project root.

Weaviate Configuration

IntellyWeave CLI (Direct)

For direct CLI operations (not needed for MCP):

Variable Description Example
WEAVIATE_IS_LOCAL Use local Weaviate instance True
LOCAL_WEAVIATE_PORT HTTP port for local instance 8080
LOCAL_WEAVIATE_GRPC_PORT gRPC port for local instance 50051
WEAVIATE_URL Weaviate instance URL http://localhost:8080

Weaviate MCP Server

Configuration for the mcp-weaviate server. These can be set in:

  • mcp-weaviate/.env file, OR
  • intellyweave.config.json env section
Variable Required Description Example
WEAVIATE_CONNECTION_TYPE ✅ Connection mode local or cloud
Local Mode
WEAVIATE_HOST If local Weaviate host localhost
WEAVIATE_PORT If local HTTP port 8080
WEAVIATE_GRPC_PORT If local gRPC port 50051
Cloud Mode
WEAVIATE_CLUSTER_URL If cloud WCS cluster URL https://cluster.weaviate.network
WEAVIATE_API_KEY If cloud WCS API key your-api-key
Timeouts
WEAVIATE_TIMEOUT_INIT Optional Init timeout (seconds) 30
WEAVIATE_TIMEOUT_QUERY Optional Query timeout (seconds) 60
WEAVIATE_TIMEOUT_INSERT Optional Insert timeout (seconds) 120

See the Weaviate MCP Setup Guide for detailed configuration.

Embeddings

Variable Description Example
VOYAGEAI_API_KEY VoyageAI API key for embeddings pa-...

AI Agent

Required for natural language queries in the interactive shell.

Variable Description Example
ANTHROPIC_API_KEY Anthropic API key sk-ant-...
AI_MODEL Claude model selection claude-haiku-4-5

Available Models

Model Description Use Case
claude-opus-4 Most capable Complex analysis
claude-sonnet-4-5 Balanced speed/quality General use
claude-sonnet-4 Medium reasoning Moderate tasks
claude-haiku-4-5 Fastest/cheapest Quick queries (default)

Development Options

Variable Description Example
MCP_STRICT Enable strict MCP schema validation 1
NO_COLOR Disable colored output 1
NO_GLYPHS Disable glyphs/emojis in output 1

Example .env File

# ============================================
# WEAVIATE CONFIGURATION
# ============================================
# Choose ONE of the following connection modes:

# Option 1: Local Weaviate Instance (Docker)
WEAVIATE_URL=http://localhost:8080
# WEAVIATE_API_KEY=           # Optional: if authentication is enabled

# Option 2: Weaviate Cloud (WCD)
# WCD_URL=https://your-cluster.weaviate.network
# WCD_API_KEY=your-wcd-api-key

# ============================================
# EMBEDDINGS (Optional)
# ============================================
# VoyageAI for vector embeddings
# VOYAGEAI_API_KEY=pa-...

# ============================================
# AI AGENT (Optional)
# ============================================
# Required for natural language queries in the shell
ANTHROPIC_API_KEY=sk-ant-...

# Claude model selection (default: claude-haiku-4-5)
AI_MODEL=claude-haiku-4-5

# ============================================
# DEVELOPMENT OPTIONS (Optional)
# ============================================
# Enable strict MCP schema validation
# MCP_STRICT=1

# Disable colored output
# NO_COLOR=1

# Disable glyphs/emojis in output
# NO_GLYPHS=1

Verification

Verify your configuration:

intellyweave config show

See Also