https://github.com/hariharen9/lamacli
Chat with LLMs from your terminal. Fast, local, and beautiful 🚀
https://github.com/hariharen9/lamacli
ai cli localllm ollama tui
Last synced: 9 months ago
JSON representation
Chat with LLMs from your terminal. Fast, local, and beautiful 🚀
- Host: GitHub
- URL: https://github.com/hariharen9/lamacli
- Owner: hariharen9
- License: mit
- Created: 2025-07-11T13:51:51.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-12T13:26:22.000Z (10 months ago)
- Last Synced: 2025-08-12T15:25:14.677Z (10 months ago)
- Topics: ai, cli, localllm, ollama, tui
- Language: Go
- Homepage: https://lamacli.netlify.app/
- Size: 10.3 MB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-cli-apps-in-a-csv - LamaCLI - AI assistante in both interactive mode and command-line mode in the terminal. (<a name="ai"></a>AI / ChatGPT)
- awesome-cli-apps - LamaCLI - AI assistante in both interactive mode and command-line mode in the terminal. (<a name="ai"></a>AI / ChatGPT)
README
# LamaCLI 🦙✨ 
  
## 🚀 Your Local LLM Assistant, Right in Your Terminal!
LamaCLI is a powerful and intuitive command-line interface (CLI) tool that brings the magic of Large Language Models (LLMs) directly to your terminal, powered by [Ollama](https://ollama.ai/).
Engage with your AI assistant in both **interactive mode** and **command-line mode** — perfect for quick queries or extended conversations, all without leaving your terminal.
---
## ✨ Features
### 🎯 Dual Operation Modes
* **Interactive Mode:** Full-featured TUI with real-time chat, file browsing, and model switching
* **CLI Mode:** Quick one-shot commands for ask, suggest, and explain operations
### 💬 Interactive Chat Features
* **Real-time Streaming:** Beautiful chat experience with live response streaming
* **Markdown Support:** Fully rendered markdown with syntax-highlighted code blocks
* **Chat Templates:** Predefined templates for common tasks (code review, documentation, debugging)
* **Chat History:** Persistent session storage with load/save functionality
* **Auto-save Sessions:** Conversations automatically saved after each interaction
* **Code Block Management:** Extract, navigate, and copy code snippets with ease
* **File Context Integration:** Inject file content into prompts using `@` command
### 🗂️ File Management
* **Built-in File Explorer:** Browse project files with keyboard navigation
* **File Viewer:** Preview file contents within the application
* **Context-aware Operations:** Include directory contents in your queries
* **Pattern Matching:** Filter files by patterns (e.g., `*.md`, `*.go`)
### 🤖 Model Management
* **Multiple Model Support:** Switch between any Ollama models seamlessly
* **Model Override:** Specify different models for different commands
* **Default Model Detection:** Automatically uses your first available model
* **Model Information:** View all available models and their status
## ⚡️ Get Started
### Prerequisites
Before you begin, ensure you have [Ollama](https://ollama.com/download) installed and running on your system. You can install Ollama using one of the following methods:
**macOS**
- Download the app from [Ollama's website](https://ollama.com/download).
- Or install via Homebrew:
```bash
brew install ollama
```
**Windows**
- Download the installer from [Ollama's website](https://ollama.com/download).
**Linux**
- Run the official installation script:
```bash
curl -fsSL https://ollama.com/install.sh | sh
```
After installation, make sure Ollama is running, then pull at least one model (e.g., `ollama pull llama3.2:3b`).
```bash
ollama pull llama3.2:3b
```
### Installation
LamaCLI is built with Go and available through multiple installation methods:
#### 📦 Via npm (Recommended)
```bash
# Install globally
npm install -g lamacli
# Or run without installing
npx lamacli
```
#### 🛠️ Via Go
```bash
go install github.com/hariharen9/lamacli@latest
```
#### 📥 Download Binary
Download the latest binary for your platform from the [releases page](https://github.com/hariharen9/lamacli/releases/latest).
### Usage
Simply run LamaCLI from your terminal:
```bash
lamacli
```
### Key Bindings
| Key | Description |
| :-------- | :------------------------------------------------------------------------ |
| `Enter` | Send message (in chat), Open file/folder (in file explorer) |
| `↑`/`↓` | Scroll history (in chat), Navigate items (in file tree/model select) |
| `@` | Trigger file context selection (in chat input) |
| `F` | Open File Explorer |
| `M` | Switch AI Model |
| `R` | Reset/Clear Chat History |
| `C` | Copy Code Blocks (when available in chat) |
| `H` | Show detailed Help screen |
| `Backspace` | Go to parent folder (in file explorer), Back to explorer (in file viewer) |
| `Esc` | Return to chat from any view (file explorer, model select, help) |
| `Ctrl+C` | Exit application (requires two presses for confirmation) |
| `L` | Load Chat History (browse and restore previous sessions) |
| `S` | Save current session manually |
| `Alt+T` | Cycle through chat templates (code review, documentation, debugging) |
| `Ctrl+T` | Cycle through themes |
## 📺 Demo Videos
Chatting with LLM
File History & Code Copy
Model Switching
Themes & Help
## 🖥️ CLI Mode Examples
While the interactive mode is the main feature, LamaCLI also supports quick CLI commands for rapid queries:
### Output Modes
LamaCLI supports two output modes when using the CLI commands:
1. **Markdown Rendering (Default)** - Displays a nicely formatted response with proper Markdown rendering after the LLM completes its response. A spinner animation with "Thinking..." text is shown while waiting for the complete response.
2. **Streaming Mode** - Displays the raw LLM response in real-time as it's generated, without Markdown rendering. Enable this mode with the `--stream` flag. The spinner stops after the first chunk of the response appears.
### Examples in CLI Mode:
```bash
# Basic question with Markdown rendering (default)
lamacli ask "How do I list files in Linux?"
# With streaming output (no Markdown rendering)
lamacli ask --stream "How do I list files in Linux?"
# With model override
lamacli a --model=qwen2.5-coder:1.5b "Explain async/await in JavaScript"
# With project context
lamacli ask --context=. --include="*.md" "Summarize this project"
```
### Get Command Suggestions
```bash
# Get command suggestions
lamacli suggest "find large files over 100MB"
# With specific model
lamacli s --model=llama3.2:1b "git workflow for teams"
```
### Explain Commands
```bash
# Explain a command
lamacli explain "find . -name '*.go' -exec grep -l 'func main' {} \;"
# With model override
lamacli e --model=qwen2.5-coder "docker compose up -d"
```
### Other Commands
```bash
# Show available models
lamacli models
# Show version
lamacli version
# Show help
lamacli help
```
**Note:** All CLI commands support the following flags for customization:
- `--model`: Override the default model
- `--context`: Specify a directory for context
- `--include`: Filter files for context
- `--theme`: Set a specific theme
- `--stream`: Enable real-time streaming output (disables Markdown rendering)
## 🤝 Contributing
We welcome contributions! If you have ideas for new features, bug fixes, or improvements, please feel free to open an issue or submit a pull request.
Please ensure your code adheres to the existing style and conventions.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details.
## ❤️ Support LamaCLI
LamaCLI is an open-source project. Your support helps keep this project alive and thriving!
## 🙏 Credits
Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea), [Lipgloss](https://github.com/charmbracelet/lipgloss), [Glamour](https://github.com/charmbracelet/glamour), [Huh](https://github.com/charmbracelet/huh), and powered by [Ollama](https://ollama.ai/).
Special thanks to [TLM](https://github.com/yusufcanb/tlm) for inspiration on the CLI command structure for ask, suggest, and explain operations.
Made with 💘 for all the terminal enthusiasts 🧑💻.
