Blazing fast GPU-accelerated terminal with 100% local Voice-to-Command & on-device LLM intelligence. Inspired by the Attic Computer from Courage the Cowardly Dog.
-blue.svg){kind=icon}
Kourage is a fork of the ultra-fast, OpenGL-accelerated Alacritty terminal that adds embedded voice commands and local natural language understanding.
Just like the legendary Attic Computer from Courage the Cowardly Dog that always had the answer to every impossible crisis, Kourage lets you type in plain English or simply speak your intent, translating it into executable shell commands directly in your active terminal session.
Important
100% Privacy & Zero Cloud Dependency: Speech recognition runs entirely on your CPU/GPU using Whisper GGML models, and language generation connects to local LLM daemons (e.g. Ollama). No voice audio or command data ever leaves your computer.
- 💬 Natural Language AI Prompt Bar: Press
Ctrl+Shift+Spaceto open an inline AI prompt bar (🤖 AI:), type your intent in plain English, and hitEnter. - 🎙️ Hands-Free Voice-to-Command: Press
Ctrl+Shift+Sand speak naturally (e.g., "show all hidden files sorted by modification time"). - 🧠 Local LLM Intent Parsing: Automatically turns natural language into valid shell commands (
ls -lat) using local models likeqwen2.5-coderorllama3. - 🔇 Smart RMS Silence Detection: Automatically detects when you stop speaking and begins transcription with zero manual cutoffs.
- ⚡ Pure High-Performance Rust: Non-blocking asynchronous worker threads ensure that voice and LLM processing never freeze Alacritty's 60+ FPS GPU render loop.
- 🔒 Safe & Offline: No API keys, no subscriptions, and no internet connection required.
+--------------------------+ +-----------------------+ +----------------------+
| 💬 Text Prompt Bar | | 🔊 Whisper STT Engine | | 🧠 Local LLM Server |
| (Ctrl+Shift+Space) | ----+ | (whisper-rs / GGML) | ----> | (Ollama / REST API) |
+--------------------------+ | +-----------------------+ +----------------------+
| ^ |
+--------------------------+ | | v
| 🎙️ Microphone | ----+-------------+ +----------------------+
| (Ctrl+Shift+S / cpal) | | 💻 Alacritty PTY |
+--------------------------+ | (Automatic Execution)|
+----------------------+
- Text Mode: Press
Ctrl+Shift+Space, type your prompt (e.g. "find all files bigger than 50MB"), and hitEnter. - Voice Mode: Press
Ctrl+Shift+S, speak your command naturally, and Whisper transcribes it. - Inference: The prompt is processed locally by your LLM (e.g. Ollama).
- Execution: The resulting shell command is injected straight into the terminal PTY.
Make sure the native system audio and build tools are installed:
# Ubuntu / Debian
sudo apt install -y libasound2-dev libopenblas-dev libclang-dev cmake pkg-config fontconfigDownload a compact GGML model (e.g. tiny or base):
mkdir -p ~/.config/alacritty/models
wget -O ~/.config/alacritty/models/ggml-tiny.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-tiny.binMake sure Ollama is installed and running:
ollama run qwen2.5-coder:3b # or: ollama run llama3Add the [voice] section to your alacritty.toml (located at ~/.config/alacritty/alacritty.toml):
[voice]
whisper_model_path = "~/.config/alacritty/models/ggml-tiny.bin"
llm_api_url = "http://localhost:11434/api/generate"
model = "qwen2.5-coder:3b" # or "llama3"
temperature = 0.0
timeout_secs = 15# Clone the repository
git clone https://github.com/Sunidhi-Satika/Kourage.git
cd Kourage
# Build & launch
cargo run --release --bin alacritty- Press
Ctrl+Shift+Spaceto open the AI prompt bar and type any command! - Press
Ctrl+Shift+Sto speak your command!
| Keybinding | Action | Description |
|---|---|---|
Ctrl + Shift + Space |
ToggleAiPrompt |
Opens/closes inline natural language AI prompt bar (🤖 AI: ) |
Ctrl + Shift + S |
VoiceCommand |
Starts microphone recording and executes transcribed AI command |
Enter (in prompt) |
AiPromptConfirm |
Submits prompt to LLM for shell command generation |
Esc (in prompt) |
AiPromptCancel |
Cancels and closes prompt overlay |
Up / Down (in prompt) |
History Nav | Cycles through previous AI prompt history |
Ctrl + W (in prompt) |
AiPromptDeleteWord |
Deletes previous word in prompt |
Enter (in preview) |
AiPreviewConfirm |
Execute previewed command immediately into shell |
Tab (in preview) |
AiPreviewEdit |
Paste into terminal prompt for manual editing before running |
Esc (in preview) |
AiPreviewCancel |
Dismiss preview without running anything |
Ctrl + Shift + + |
IncreaseFontSize |
Increase terminal font size |
Ctrl + Shift + - |
DecreaseFontSize |
Decrease terminal font size |
- Interactive Preview & Safety Guard: Full interactive preview bar for all AI commands (
Enterto run,Tabto edit arguments,Escto cancel) with intelligent danger analysis (red⚠️ warnings forrm -rf,mkfs,dd,git reset --hard,git push --force, etc.). - Context Awareness Engine: Automatically extracts active CWD (
/proc/<pid>/cwd), directory files, tech stack detection (Rust/Cargo, Node/npm, Python, Go, Docker, Git), active shell, OS distro, and recent terminal buffer output to provide hyper-accurate command generation. - Natural Language Text Prompt Bar (
Ctrl+Shift+Space): Inline prompt overlay with typing, cursor, history (Up/Down), word deletion (Ctrl+W), and execution. - Local Voice Capture & STT (
Ctrl+Shift+S): Hands-free voice capture with silence auto-cutoff (cpal+whisper-rs). - Local LLM Engine: REST API client querying local LLM daemon (Ollama / Qwen / Llama).
- Visual Feedback: Real-time stage updates ("🎙️ Recording...", "⚙️ Transcribing...", "🤖 Generating LLM...") and error notifications in the message bar.
- Configurable LLM Settings: Configurable model, temperature, timeout, and tilde
~path resolution. - Error Diagnosis & Fix (
Ctrl+Shift+E): Analyze recent terminal errors and suggest automated fixes.
Kourage is released under the Apache License, Version 2.0.