Bird logo
Lumo CLI

Lumo CLI Installation Guide

Get started with Lumo CLI in minutes with these simple installation steps.

Available Now

Installation Methods

Method 1: Install from Source

Building from source ensures you have the latest features and improvements: 

# From source
git clone https://github.com/agnath18K/lumo_cli.git
cd lumo_cli
make build
sudo make install

# Verify the installation
lumo --version

Method 2: Using Pre-built Binaries

The recommended quick approach is to use pre-built binaries for your platform: 

# Using pre-built binary (Linux)
curl -L https://github.com/agnath18K/lumo_cli/releases/download/v1.0.2/lumo_1.0.2_linux_amd64.tar.gz -o lumo.tar.gz
tar -xzf lumo.tar.gz
sudo mv lumo /usr/local/bin/

# Using Debian package
curl -L https://github.com/agnath18K/lumo_cli/releases/download/v1.0.2/lumo_1.0.2_amd64.deb -o lumo.deb
sudo dpkg -i lumo.deb

# Verify the installation
lumo --version

First-Time Setup

When you first run Lumo CLI, it will guide you through an interactive setup process:

1. Configuration Initialization

Lumo CLI automatically creates the necessary configuration directory at ~/.config/lumo/ and generates default configuration files if they don't exist.

2. AI Provider Selection

You'll be prompted to choose your preferred AI provider:

  • Google Gemini: Generally faster with good performance for terminal tasks
  • OpenAI: May provide more detailed explanations for complex queries
  • Ollama: Local AI inference without requiring internet connectivity

3. API Key Configuration

You'll need to provide API keys for your chosen provider(s):

  • For Gemini: Get your API key from Google AI Studio
  • For OpenAI: Get your API key from OpenAI Platform
  • For Ollama: Provide the URL where Ollama is running (default: http://localhost:11434)
Setup & Configuration 
# First-time setup will guide you through configuration
lumo

# Or manually configure providers
lumo config:provider set gemini
lumo config:key set gemini YOUR_API_KEY

# Test your configuration
lumo "Hello, how does the grep command work?"

Ready to Transform Your Terminal Experience?

Get started with Lumo CLI today and navigate the terminal with the power of natural language.

  • Natural language command processing
  • Terminal agent mode for complex tasks
  • Multi-provider AI support
  • System health monitoring
  • Pipe support for command analysis
  • Chat mode for conversational help
Install Lumo CLI View on GitHub