Zev: 자연어로 터미널 명령을 빠르게 쿼리할 수 있는 CLI 도구

10.9K 00

일반 소개

Zev는 사용자가 자연어로 터미널 명령을 빠르게 쿼리하고 생성할 수 있도록 도와주는 사용하기 쉬운 명령줄 인터페이스(CLI) 도구입니다. Zev는 복잡한 명령 구문을 외우는 대신 일상적인 언어로 요구 사항을 설명하여 터미널 명령을 생성합니다. OpenAI API 또는 네이티브 기반 Ollama 모델과 마찬가지로 Zev는 파일 관리, 프로세스 보기, 네트워크 검사 및 Git 작업과 같은 다양한 운영 시나리오를 지원합니다. Zev는 명령줄 사용의 문턱을 낮추도록 설계되어 개발자와 초보자에게 적합합니다. 사용자는 이를 사용하려면 OpenAI API 키 또는 로컬 Ollama 환경을 구성해야 합니다. zev의 코드는 GitHub에서 오픈 소스이므로 사용자가 자유롭게 기여하고 커스터마이징할 수 있습니다.

기능 목록

터미널 명령을 자연어로 생성합니다(예: "현재 디렉토리 디스크 사용량 표시").
파일 조작, 프로세스 관리, 네트워크 검사, Git 명령 등 다양한 운영 시나리오를 지원합니다.
지능형 명령 생성을 제공하기 위해 OpenAI API와 통합.
기본 Ollama 모델을 지원하며 오프라인 작동이 가능합니다.
사용자가 설정을 업데이트할 수 있는 API 키 관리 기능을 제공합니다.
오픈 소스 코드, 커뮤니티 기여 및 기능 확장 지원.

도움말 사용

설치 프로세스

Zev는 간단한 설치 및 구성 프로세스를 갖춘 Python 개발 CLI 도구입니다. 자세한 단계는 다음과 같습니다:

클론 창고
터미널을 열고 다음 명령을 실행하여 Zev의 GitHub 리포지토리를 복제합니다:
```
git clone https://github.com/dtnewman/zev.git
```

복제가 완료되면 프로젝트 디렉토리로 이동합니다:

cd zev

종속성 설치
Zev는 Python 3.6 이상 환경이 필요합니다. Python이 설치되어 있는지 확인한 다음 필요한 종속성을 설치하세요:
```
pip install -r requirements.txt
```
종속성에는 OpenAI의 Python 클라이언트 라이브러리 등이 포함되며, 자세한 내용은 requirements.txt 보기.
OpenAI API 키 구성
Zev를 처음 실행하면 OpenAI API 키를 입력하라는 메시지가 표시됩니다. 사용자는 OpenAI 웹사이트에서 계정을 등록하고 키를 생성해야 합니다. 다음 명령을 실행하여 구성을 시작합니다:
```
python zev.py
```
메시지에 따라 키를 입력하면 로컬 구성 파일에 키가 저장됩니다.
키를 업데이트해야 하는 경우 실행하세요:
```
zev --update-key
```
(선택 사항) 올라마 모델 구성하기
Zev를 로컬에서 실행하려면 Ollama를 설치하고 로컬 모델을 구성하면 됩니다:
- 올라마 웹사이트를 방문하여 올라마를 다운로드하고 설치하세요.
- 예를 들어 Ollama 서비스를 시작하고 모델을 선택합니다:
```
ollama run llama3
```
- Zev 구성에서 올라마 모드를 활성화하고 실행합니다:
```
zev --use-ollama
```
이를 통해 Zev는 네트워크 환경이 없거나 개인정보 보호에 민감한 사용자에게 적합한 로컬 모델을 사용할 수 있습니다.
Zev 실행
설치 및 구성이 완료되면 다음 명령을 실행하여 Zev를 시작합니다:
```
python zev.py
```

주요 기능

Zev의 핵심 기능은 자연어를 통해 터미널 명령을 생성하는 것입니다. 작동 방식은 다음과 같습니다:

터미널 명령어 쿼리
터미널에 다음을 입력합니다. zev 를 입력한 다음 자연어 설명을 입력합니다. 예를 들어 실행 중인 모든 Python 프로세스를 보려면 다음과 같이 하세요:
```
zev 'show all running python processes'
```
Zev는 다음과 같은 것을 반환합니다. ps aux | grep python 명령어를 사용합니다. 사용자가 직접 실행을 복사할 수 있습니다.
파일 작업
예를 들어 최근에 수정한 파일을 찾습니다:
```
zev 'find all .py files modified in the last 24 hours'
```
출력 명령은 다음과 같습니다:
```
find . -type f -name "*.py" -mtime -1
```
시스템 정보 문의
디스크 사용량을 확인합니다:
```
zev 'show disk usage for current directory'
```
다음과 같은 명령을 출력합니다:
```
du -sh .
```
네트워크 확인
네트워크 연결을 테스트합니다. 예를 들어
```
zev 'check if google.com is reachable'
```
출력 명령은 다음과 같습니다:
```
ping -c 4 google.com
```
Git 작업
Git에서 커밋되지 않은 변경 내용을 확인합니다:
```
zev 'show uncommitted changes in git'
```
다음과 같은 명령을 출력합니다:
```
git status
```

주요 기능 작동

로컬 올라마 모델 지원
Ollama로 Zev를 실행하면 완전히 오프라인 상태이며 데이터 프라이버시를 보호합니다. 일단 구성이 완료되면 Zev는 인터넷에 연결할 필요 없이 로컬 모델을 자동으로 호출하여 명령을 생성합니다.
예시:
```
zev --use-ollama 'list all files in current directory'
```
출력 명령:
```
ls -la
```
API 키 관리
사용자는 언제든지 OpenAI 키를 업데이트하거나 모델을 전환할 수 있습니다. 실행:
```
zev --update-key
```
메시지에 따라 새 키를 입력하면 구성이 즉시 적용됩니다.

취급 시 주의사항

OpenAI API를 사용하려면 네트워크가 안정적인지 확인하세요. Ollama를 사용하는 경우 모델 서비스를 미리 시작해야 합니다.
입력에 대한 자연어 설명은 모호함을 피하기 위해 가능한 한 명확하고 구체적으로 작성합니다. 예를 들어 "문서 목록"은 다음과 같이 생성될 수 있습니다. ls를 클릭하고 "모든 숨겨진 파일 나열"을 선택하면 ls -a.
Zev가 생성한 명령은 참고용으로만 제공되며, 실행하기 전에 명령이 기대에 부합하는지 확인하는 것이 좋습니다.

고급 사용

사용자 지정 명령 생성
사용자는 Zev의 GitHub 리포지토리를 포크하여 특정 시나리오를 지원하도록 코드를 수정할 수 있습니다. 예를 들어 사용자 지정 명령 템플릿을 추가하거나 다른 AI 모델을 지원할 수 있습니다.
일괄 작업
Zev는 현재 일괄 명령 생성을 지원하지 않지만, 사용자는 스크립트를 통해 Zev를 호출할 수 있습니다. zev 명령을 사용하여 여러 작업을 처리할 수 있습니다.

애플리케이션 시나리오

개발자 디버깅 환경
프로세스나 파일의 상태를 확인하는 등 코드를 디버깅할 때 터미널 명령을 자주 사용하는 개발자의 경우 Zev를 사용하면 자연어로 명령을 빠르게 생성할 수 있어 시간을 절약할 수 있습니다. 예를 들어 "포트 8080에서 프로세스 찾기"를 입력하면 Zev는 다음과 같은 명령을 생성합니다. lsof -i :8080.
초보자를 위한 명령줄 배우기
명령줄을 처음 접하는 사람들은 복잡한 구문을 기억하지 못해 좌절하는 경우가 많은데, Zev는 자연어 입력을 통해 학습의 장벽을 낮춰줍니다. 예를 들어 "현재 폴더에 있는 모든 파일 크기 표시"라고 입력하면 Zev가 다음과 같이 생성합니다. ls -lh를 통해 사용자가 빠르게 속도를 높일 수 있습니다.
시스템 관리자를 위한 일일 유지 관리
서버의 상태를 확인하거나 네트워크 진단을 수행해야 하는 시스템 관리자를 위해 Zev는 "디스크 공간 확인" 명령을 생성하는 "디스크 공간 확인" 명령과 같은 명령의 빠른 생성을 지원합니다. df -h를 사용하여 효율성을 향상시킬 수 있습니다.

QA

Zev는 어떤 운영 체제를 지원하나요?
Zev는 macOS, Linux 및 Windows를 지원합니다(Python 환경 필요). 일부 명령은 시스템 차이로 인해 수동으로 조정해야 할 수 있습니다.
OpenAI API를 사용해야 하나요?
Zev는 오프라인에서 사용하거나 클라우드 서비스에 의존하고 싶지 않은 사용자를 위해 로컬 Ollama 모델을 지원합니다.
코드 기여는 어떻게 하나요?
인터뷰 https://github.com/dtnewman/zev리포지토리에 기여하는 방법에 대한 자세한 내용은 리포지토리의 CONTRIBUTING.md.
Zev가 생성한 명령은 안전한가요?
Zev가 생성하는 명령은 사용자 입력과 모델 추론을 기반으로 합니다. 잠재적인 위험을 방지하기 위해 실행 전에 명령의 내용을 확인하는 것이 좋습니다.