Zev helps you remember (or discover) terminal commands using natural language.
pip install zevThis project runs on top of the OpenAI API. After your first time running it, you will be prompted to enter an OpenAI key.
zevzev '<what you want to do>'# Find running processes
zev 'show all running python processes'
# File operations
zev 'find all .py files modified in the last 24 hours'
# System information
zev 'show disk usage for current directory'
# Network commands
zev 'check if google.com is reachable'
# Git operations
zev 'show uncommitted changes in git'You can update your OpenAI API key or other settings by running:
zev --setupTo use the OpenAI key, you must have an OpenAI account and a subscription. You can create an API key on this page.
You can use Zev with Ollama as an alternative to OpenAI, which lets you run all commands locally. To set this up:
-
Install and start Ollama with a model of your choice
-
Run
zev --setupand put in the proper settings. For example:
? Pick your LLM provider: Ollama
? Enter the Ollama URL: http://localhost:11434/v1
? Enter the model to use (e.g. llama3.2): llama3.2
Note that to switch backends, you can re-run zev --setup again at any time.
Contributions are welcome! Feel free to open issues or submit pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.