Environment Variables

Configure Stellarion using environment variables. Set these in .stellarion/.env in your project directory.

API Keys

OPENAI_API_KEY

OpenAI API key for enhanced AI features.

OPENAI_API_KEY=sk-your-api-key-here

Required for: Enhanced semantic search, advanced analysis

Note: Basic functionality works without an API key.

Model Configuration

ROBERTA_MODEL_PATH

Path to RoBERTa model files for local semantic search.

ROBERTA_MODEL_PATH=/path/to/models/roberta-base

Default: ~/.stellarion/models/roberta-base

Note: Download models using the setup script:

curl -sSL https://stellarion.dev/download-models.sh | bash

Logging

STELLARION_LOG_LEVEL

Control logging verbosity.

STELLARION_LOG_LEVEL=info

Values:

• debug — Verbose debugging information
• info — Standard operational messages
• warn — Warnings only
• error — Errors only

Default: info

RUST_LOG

Logging level for the Rust native module.

RUST_LOG=info

Values: Same as STELLARION_LOG_LEVEL

Server Configuration

MCP_SERVER

Indicates the application is running as an MCP server.

MCP_SERVER=true

Note: Set automatically when running as MCP server. Do not modify.

REPO_PATH

Override the default project path.

REPO_PATH=/path/to/project

Default: Current working directory

Example Configuration

Complete .stellarion/.env file:

OPENAI_API_KEY=sk-your-key-here

ROBERTA_MODEL_PATH=/Users/dev/.stellarion/models/roberta-base

STELLARION_LOG_LEVEL=info
RUST_LOG=info

Loading Order

Environment variables are loaded in this order:

1. System environment variables
2. .stellarion/.env file
3. Command-line arguments (where applicable)

Later values override earlier ones.

Security Notes

• Never commit .stellarion/.env with API keys to version control
• Add .stellarion/.env to your .gitignore
• Use environment variables in CI/CD instead of files