Environment Variables

January 12, 2026 · View on GitHub

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