mirrors/lumen
1
0
Fork 0
mirror of https://github.com/jnsahaj/lumen.git synced 2025-12-23 05:36:48 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Instant AI Git Commit message, Git changes summary from the CLI (no API key required)
45 commits 11 branches 14 tags 470 KiB
Find a file
Sahaj Jain 84eef3a8bc
Update README.md
2024-10-31 01:30:55 +05:30
src chore: Bump ver 2024-10-31 01:03:16 +05:30
.gitignore feat: Initial setup using openai and keyring 2024-10-29 01:00:27 +05:30
Cargo.lock chore: Bump ver 2024-10-31 01:03:16 +05:30
Cargo.toml chore: Bump ver 2024-10-31 01:03:16 +05:30
LICENSE Create LICENSE 2024-10-30 04:39:38 +05:30
README.md Update README.md 2024-10-31 01:30:55 +05:30

README.md

lumen

lumen is a free CLI tool that uses AI to summarise git commits.

lumen-demo

Supported providers

Provider API Key Required Models
Groq groq Yes (free) llama2-70b-4096, mixtral-8x7b-32768 (default: mixtral-8x7b-32768)
OpenAI openai Yes gpt-4o, gpt-4o-mini, gpt-4, gpt-3.5-turbo (default: gpt-4o-mini)
Phind phind (Default) No Phind-70B

Installation

  1. Cargo: cargo install lumen

Prerequisites

  1. git
  2. fzf (optional): Required for lumen list command
  3. mdcat (optional): Required for pretty output formatting

Usage

$ lumen --help

# summarise a commit by giving its SHA-1
# eg: lumen explain HEAD
# eg: lumen explain cc50651f
$ lumen explain <commit-hash>

# fuzzy-search (using fzf) commits, and then `explain`
$ lumen list

Configure AI Provider

Using CLI args:

$ lumen --provider="openai" --api-key="<your-api-key>" --model="gpt-4o" explain HEAD
$ lumen --provider="openai" --api-key="<your-api-key>" list

Using Environment variables:

LUMEN_AI_PROVIDER (default: "phind")
LUMEN_API_KEY (when applicable)
LUMEN_AI_MODEL (when applicable)