Emigo: Emacs에서 AI를 사용한 복잡한 프로그래밍 작업을 위한 도우미

12.2K 00

일반 소개

Emigo는 대규모 언어 모델(LLM)을 통합하여 프로그래머가 Emacs에서 코드 분석 및 수정과 같은 작업을 할 수 있도록 도와주는 Emacs용 오픈 소스 AI 프로그래밍 도우미로, MatthewZMD가 GitHub에서 개발했습니다. 에미고는 대규모 언어 모델(LLM)을 통합하여 프로그래머가 에맥스에서 코드를 분석, 생성 및 수정할 수 있도록 도와주는 에맥스용 오픈 소스 AI 프로그래밍 도우미로, MatthewZMD가 GitHub에서 개발했으며 에미고의 핵심 기능은 텍스트 생성뿐만 아니라 파일 읽기, 코드 작성 또는 명령 실행과 같은 도구를 통해 프로젝트와 상호작용하는 "에이전틱 AI(Agentic AI)" 기능입니다. 텍스트를 생성할 뿐만 아니라 파일 읽기, 코드 작성, 명령어 실행 등 도구를 통해 프로젝트와 상호작용할 수 있습니다. Aider에서 개발했으며 Cline 에미고는 에이더맥스와 같은 도구에서 영감을 얻은 에이더맥스의 후속작입니다. 현재 Emigo는 베타 테스트 중이며 개발자들이 사용해보고 피드백을 제공할 수 있도록 기능을 계속 개선하고 있습니다.

기능 목록

에이전트 기반 도구 사용파일 읽기 또는 쓰기 또는 명령 실행과 같은 작업 요구 사항에 따라 AI가 도구를 선택하고 실행합니다.
Emacs와의 원활한 통합인터페이스와 바로 가기가 Emacs 기본 환경과 일치합니다.
여러 AI 모델 지원사용자가 무료로 사용할 수 있는 LiteLLM을 통해 OpenRouter, Deepseek 등과 같은 모델에 연결합니다.
컨텍스트 관리(컴퓨팅)대화 기록 및 프로젝트 파일을 자동으로 기록하여 일관성 있는 대화를 보장합니다.
파일 컨텍스트 추가"@" 기호를 통해 AI 분석에 파일을 빠르게 추가할 수 있습니다.
코드 패치 생성 및 표시AI가 반환한 코드 변경 사항을 쉽게 볼 수 있도록 강조 표시합니다.

도움말 사용

Emigo는 Emacs 사용자를 위한 AI 비서입니다. 빠르게 시작할 수 있도록 설치 및 사용 방법에 대한 자세한 지침을 확인하세요.

설치 프로세스

환경 요구 사항 검사
- Emacs 버전 28 이상이 필요합니다. https://www.gnu.org/software/emacs/ 에서 다운로드하여 설치할 수 있습니다.
- 파이썬 3.x가 필요하며, 설치되어 있는 경우 건너뛰고 설치되어 있지 않은 경우 https://www.python.org/ 에서 다운로드할 수 있습니다.
Emigo 다운로드
터미널에서 다음 명령을 실행하여 Emigo를 Emacs 구성 디렉토리에 복제합니다:

git clone https://github.com/MatthewZMD/emigo.git ~/.emacs.d/emigo

Python 종속성 설치
Emigo 디렉토리로 이동하여 실행합니다:

cd ~/.emacs.d/emigo
pip install -r requirements.txt

그러면 LiteLLM과 같은 필요한 Python 라이브러리가 설치됩니다.

Emacs 구성
Emacs 구성 파일을 엽니다(일반적으로 ~/.emacs.d/init.el)에 다음 코드를 추가합니다:

(use-package emigo
:straight (:host github :repo "MatthewZMD/emigo")
:config
(emigo-enable) ;; 自动启动后台进程
:custom
(emigo-model "openrouter/deepseek/deepseek-chat-v3-0324") ;; 设置默认模型
(emigo-base-url "https://openrouter.ai/api/v1") ;; 设置 API 地址
(emigo-api-key (emigo-read-file-content "~/.config/openrouter/key.txt"))) ;; 加载 API 密钥

구성::
- emigo-modelAI 모델 선택, 추천 OpenRouter 딥시크의
- emigo-base-url: API 서비스 주소를 입력합니다.
- emigo-api-keyOpenRouter(https://openrouter.ai)에서 키를 가져와 지정된 경로에 저장합니다.

설치 확인
구성을 저장한 후 Emac을 재시작합니다. M-x emigo새 버퍼가 나타나면 설치에 성공한 것입니다.

사용 방법

Emigo 작업은 주로 바로 가기와 대화형 창을 결합하여 Emacs에서 수행됩니다.

Emigo 시작

프로젝트 디렉터리에서 다음을 입력합니다. M-x emigo전용 버퍼는 캐리지 리턴 후에 열립니다.
Git 리포지토리에 있는 경우 Emigo는 리포지토리의 루트 디렉터리를 세션 경로로 사용합니다. 현재 디렉터리를 사용하려면 다음과 같이 입력합니다. C-u M-x emigo.

입력 프롬프트

예를 들어 버퍼에 요구 사항을 입력합니다:

请优化 @src/main.py 中的排序函数

Emigo는 자동으로 src/main.py 처리하기 위해 AI로 전송됩니다.

컨텍스트에 파일 추가하기

"@" 기호가 있는 파일을 참조하세요. @src/utils.py그렇지 않은 경우 Emigo가 컨텍스트에 추가합니다.
컨텍스트 파일을 보려면: 다음을 누릅니다. C-c C-l(실행 중) emigo-list-context-files).
파일을 삭제하려면: 다음을 누릅니다. C-c C-f(실행 중) emigo-remove-file-from-context).

AI와 상호 작용하기

작업을 입력하면 AI가 이를 분석하여 결과를 반환합니다. 예를 들어

请帮我调试 @src/main.c 中的内存泄漏

AI가 반환한 패치는 다음과 같이 강조 표시됩니다:

- free(ptr);
+ if (ptr) free(ptr);

도구 사용 프로세스

Emigo의 에이전트 기반 기능은 도구를 통해 구현되며, AI는 다음과 같은 작업에 따라 도구를 선택합니다:
read_file: 파일 내용을 읽습니다.
write_to_file: 파일에 쓰기.
execute_command명령을 실행합니다.
AI가 메시지를 표시할 수 있습니다:

我需要运行 gcc -o test main.c，同意吗？

를 누릅니다. y 도구가 실행된 후 대화 상자에 결과가 입력되는지 확인합니다.

세션 관리

컨텍스트 확인: 사용 C-c C-l 현재 파일 목록을 봅니다.
세션 다시 시작: 버퍼를 닫고 다시 실행합니다. M-x emigo.

개발 상태 알림

Emigo는 현재 베타 버전으로 API 변경, 불안정한 기능 또는 불완전한 문서가 있을 수 있습니다. 테스트 목적으로만 사용하고 이슈는 GitHub를 통해 제출하는 것이 좋습니다.

애플리케이션 시나리오

코드 디버깅
C 프로젝트에서 충돌을 발견하면 "@main.c에서 오류 확인"이라고 입력하면 AI가 이를 분석하여 수정 사항을 제안합니다.
문서 재구성
"@src/utils.py의 함수 리팩터링"을 입력하면 Emigo가 최적화된 코드를 생성하고 패치를 표시합니다.
명령 실행
프로젝트에 "compile @src/main.c"를 입력하면 AI가 다음을 선택합니다. execute_command 도구 작동 gcc.

QA

Emigo는 어떤 모델을 지원하나요?
오픈라우터의 딥시크, 안트로픽의 딥시크와 같은 여러 모델이 LiteLLM을 통해 지원됩니다. Claude 등을 사용하려면 설정에서 모델 이름과 API를 지정하기만 하면 됩니다.
프롬프트가 응답하지 않는 이유는 무엇인가요?
API 키가 잘못되었거나 네트워크 문제가 있을 수 있습니다. 키 파일 경로와 네트워크 연결이 올바른지 확인합니다. emigo-base-url 접근성.
Emigo는 어떻게 업데이트하나요?
존재 ~/.emacs.d/emigo 디렉토리 실행 git pull를 클릭한 다음 Emacs를 다시 시작합니다.