lunar-cli 0.1.0

CLI for Lunar API - chat completions and semantic routing

Lunar CLI

Command-line interface for the Lunar API - chat completions and semantic routing.

Install

pip install -e .

Quick Start

# Configure authentication
lunar config set api-key YOUR_API_KEY

# Chat completion
lunar chat "Hello world" -m gpt-4o-mini

# Streaming
lunar chat "Explain recursion" -m claude-3-5-sonnet --stream

# Semantic routing - picks the best model for your prompt
lunar router route "Explain quantum computing" -m gpt-4o-mini,claude-3-5-sonnet

# Routing with cost optimization
lunar router route "Write a poem" -m gpt-4o-mini,claude-3-5-sonnet -c 0.5

# Dry run - see routing decision without executing
lunar router route "Hello" -m gpt-4o-mini,claude-3-5-sonnet --dry-run

# List models and providers
lunar models
lunar providers -m gpt-4o-mini

Commands

Command	Description
lunar chat	Send a chat completion request
lunar router route	Route a prompt to the best model
lunar router profiles	List semantic routing profiles
lunar models	List available models
lunar providers	List available providers
lunar config show	Show current configuration
lunar config set	Set a config value
lunar config get	Get a config value
lunar config delete	Delete a config value

Configuration

Config is stored in ~/.lunar/config.json. Environment variables are used as fallbacks:

Config Key	Env Variable	Description
api-key	LUNAR_API_KEY	API key
jwt	LUNAR_JWT	JWT token
environment	LUNAR_ENV	dev or prod (default: prod)
base-url	-	Custom API base URL
timeout	-	Request timeout in seconds