{"id":27798778,"url":"https://github.com/dtnewman/zev","last_synced_at":"2026-01-06T08:58:22.740Z","repository":{"id":284202562,"uuid":"953803366","full_name":"dtnewman/zev","owner":"dtnewman","description":"A simple CLI tool to help you remember terminal commands","archived":false,"fork":false,"pushed_at":"2025-04-30T17:02:50.000Z","size":8234,"stargazers_count":558,"open_issues_count":4,"forks_count":29,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-30T18:22:32.416Z","etag":null,"topics":["cli","llm"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dtnewman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-24T05:21:42.000Z","updated_at":"2025-04-30T17:59:43.000Z","dependencies_parsed_at":"2025-04-22T04:40:18.227Z","dependency_job_id":null,"html_url":"https://github.com/dtnewman/zev","commit_stats":null,"previous_names":["dtnewman/avi","dtnewman/zev"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtnewman%2Fzev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtnewman%2Fzev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtnewman%2Fzev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtnewman%2Fzev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dtnewman","download_url":"https://codeload.github.com/dtnewman/zev/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251759406,"owners_count":21639225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","llm"],"created_at":"2025-04-30T23:01:38.917Z","updated_at":"2026-01-06T08:58:22.735Z","avatar_url":"https://github.com/dtnewman.png","language":"Python","funding_links":[],"categories":["Python","\u003ca name=\"ai-cli-commands\"\u003e\u003c/a\u003eAI terminal command generator"],"sub_categories":[],"readme":"# Zev 🔍\n\n[![PyPI version](https://badge.fury.io/py/zev.svg)](https://badge.fury.io/py/zev)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nZev helps you remember (or discover) terminal commands using natural language.\n\n![Description](./.github/demo.gif)\n\n## 🔧 Installation\n\n```bash\npip install zev\n```\n\n- **Note:** This project runs on top of LLM APIs like OpenAI, Google's Gemini, or [Ollama](https://ollama.com/).\n\n## 📦 Dependencies\n\nFor clipboard functionality (copying and pasting) to work properly, you may need to install:\n\n- On Linux: `xclip` or `xsel` (for X11) or `wl-clipboard` (for Wayland)\n- On macOS: No additional dependencies needed\n- On Windows: No additional dependencies needed\n\n## 🎮 Usage\n\n### Option 1: Interactive Mode\n\n```bash\nzev\n```\n\n### Option 2: Direct Query\n\n```bash\nzev '\u003cwhat you want to do\u003e'\n```\n\n## 📝 Examples\n\n```bash\n# Find running processes\nzev 'show all running python processes'\n\n# File operations\nzev 'find all .py files modified in the last 24 hours'\n\n# System information\nzev 'show disk usage for current directory'\n\n# Network commands\nzev 'check if google.com is reachable'\n\n# Git operations\nzev 'show uncommitted changes in git'\n```\n\n## 🛡️ Safety Considerations\n\n⚠️ Commands are generated by LLMs. While the tool attempts to flag dangerous commands, it may not always do so. Use caution.\n\n![Example of dangerous command warning](./.github/dangerous_example.png)\n\n## ⚙️ Settings\n\n### **Supported LLM Providers:**\n\n- OpenAI\n- Google Gemini\n- Ollama\n- Azure OpenAI\n\nYou can update your API keys and provider settings by running:\n\n```bash\nzev --setup\n```\n\n### OpenAI\n\nTo use OpenAI, you need an OpenAI account and a subscription. You can create an API key on [this page](https://platform.openai.com/settings/organization/api-keys).\n\n### Google Gemini (Free)\n\nTo use Google's Gemini models, you need a Google AI Studio account. You can create a Gemini API key in [Google AI Studio](https://aistudio.google.com/).\n\n## 🐪 Using with Ollama\n\nYou can use Zev with [Ollama](https://ollama.ai/) as an alternative to hosted providers, which lets you run all commands locally. To set this up:\n\n1. Install and start [Ollama](https://ollama.com/) with a model of your choice\n\n2. Run `zev --setup` and put in the proper settings. For example:\n\n``` bash\n? Pick your LLM provider: Ollama\n? Enter the Ollama URL: http://localhost:11434/v1\n? Enter the model to use (e.g. llama3.2): llama3.2\n```\n\n### Azure OpenAI\n\nTo use Azure OpenAI, you’ll need access to an [Azure OpenAI](https://azure.microsoft.com/en-us/products/ai-services/openai-service) resource in your Azure subscription.\n\n1. Create a deployment of the model you want to use (e.g., `gpt-4o`, `gpt-4o-mini` etc.).\n\n1. Install required Azure depedencies with `pip install zev[azure]`.\n\n1. Run `zev --setup` and put in the proper settings. For example:\n\n    ``` bash\n    ? Pick your LLM provider: Azure OpenAI\n    ? Azure OpenAI account name (e.g. my-openai-resource): my-openai-resource\n    ? Azure OpenAI API key (leave blank to use Entra ID / keyless auth):\n    ? Azure OpenAI deployment name (e.g. gpt-4, gpt-4o, etc): gpt-4o\n    ? Azure OpenAI API version: 2025-03-01-preview\n    ```\n\n    \u003e **Note:** Model version must be 2024-08-06 or newer.  \n    \u003e API version must be 2024-08-01-preview or newer.\n\nNote that to switch backends, you can re-run `zev --setup` again at any time.\n\n## 🤝 Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtnewman%2Fzev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdtnewman%2Fzev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtnewman%2Fzev/lists"}