A modern terminal powered by artificial intelligence, inspired by Warp.
Termaid allows you to describe what you want to do in natural language and the AI generates the appropriate shell commands.
🤖 This project was entirely built with AI — from architecture to code, tests, and documentation.
Generate shell commands from natural language and get AI-powered interpretations of command output.
Warp is a great AI-powered terminal, but its AI features only work with proprietary cloud providers — there is no support for Ollama, which means no free, local, or self-hosted option.
Termaid was born out of that frustration: a fully open alternative that works with Ollama out of the box, keeping your data local and your wallet intact.
- Terminal Base: Full terminal interface with xterm.js
- Integrated AI: Generate shell commands from natural language descriptions
- Multi-Provider LLM: Supports Ollama (local/remote), Claude (Anthropic API), and OpenAI (GPT-4o, GPT-4)
- Modern Interface: Dark theme by default with optional light theme
- Flexible Configuration: Provider, model, temperature, and more — configurable via UI or environment variables
- History: Track conversations and executed commands
Termaid uses llama3.2:3b as the default Ollama model, offering a good balance between performance and resource usage.
Depending on your hardware and needs, you can configure alternative models:
| Model | Size | RAM Required | Description |
|---|---|---|---|
| llama3.2:3b | 3B | ~4 GB | Default - Best balance of speed and quality |
| llama3.1:8b | 8B | ~8 GB | More powerful, better for complex commands |
| mistral:7b | 7B | ~6 GB | Good compromise between performance and quality |
| qwen2.5:3b | 3B | ~4 GB | Lightweight alternative, fast responses |
You can change the model in the configuration panel (⚙️ icon) or via the environment variable:
export TERMAID_OLLAMA_MODEL=llama3.1:8bFor more details, see the Configuration guide.
Download the latest release for your platform:
| Platform | Format | Download |
|---|---|---|
| Linux | AppImage | Termaid-1.4.0.AppImage |
| Linux | Debian/Ubuntu | termaid_1.4.0_amd64.deb |
| macOS | DMG (ARM) | Termaid-1.4.0-arm64.dmg |
| Windows | Installer | Termaid.Setup.1.4.0.exe |
See all versions on the Releases page.
git clone https://github.com/openhoat/termaid.git
cd termaid
npm install
npm run devPrerequisites: Node.js 18+, npm, and an LLM provider (Ollama, Claude, or OpenAI).
See the Getting Started guide for detailed setup instructions including LLM provider configuration.
- Getting Started — Installation and provider setup
- Usage — How to use the AI assistant and keyboard shortcuts
- Configuration — Provider settings and environment variables
- Build Executables — Package the app for distribution
- Architecture — Project structure and design overview
- Troubleshooting — Common issues and solutions
- Contributing — How to contribute to the project
- Changelog — Version history and release notes
- Commands proposed by AI are not executed automatically
- You always have control: validation before execution
- Ability to modify commands before execution
- Configuration stored locally with electron-store
This project is licensed under the MIT License - see the LICENSE.txt file for details.
Copyright © 2026 Olivier Penhoat
Olivier Penhoat openhoat@gmail.com
- Warp for the inspiration
- The Ollama team for their excellent tool
- Anthropic for the Claude API
- The open-source community