ochyai/vibe-local

해결하는 문제

vibe-local은 맥과 리눅스 사용자를 위한 완전히 무료이고 오프라인에서 작동하는 AI 코딩 환경을 제공합니다. 유료 API 구독이나 지속적인 인터넷 연결이 필요 없어, 학생, 초보자, 또는 오프라인 워크숍과 같은 네트워크 제한 환경에서도 AI 기반 프로그래밍에 접근할 수 있습니다.

작동 방식

이 프로젝트는 Ollama(로컬 LLM 실행용), TUI(주로 OpenCode 엔진 사용), 그리고 최적화된 로컬 모델(Qwen, gpt-oss 등)을 통합하는 런처 및 구성 계층으로 작동합니다.

주요 기술적 특징:

• 자동 모델 선택: 시스템 RAM을 감지하여 적절한 컨텍스트 창 크기(num_ctx)를 가진 Ollama 모델 별칭(vibe-coder, vibe-fast 등)을 자동 생성하여 메모리 오류를 방지합니다.
• 지능형 라우팅: vibe-router는 작은 모델로 빠른 채팅을 처리하고, 복잡한 코딩 작업에는 큰 모델을 사용하도록 작업을 분할합니다.
• 유연한 UI 옵션: OpenCode TUI, Claude Code CLI 호환 모드, 또는 내장된 Python 기반 엔진(vibe-coder.py) 중 선택 가능합니다.
• 로컬 RAG: 내장된 Python 엔진은 sqlite3과 Ollama 임베딩을 사용해 로컬 Retrieval-Augmented Generation을 지원하며, 코드베이스 컨텍스트를 프롬프트에 주입합니다.

대상 사용자

• 학생 및 교육자: 비영리 연구 및 교육을 위해 특별히 설계되었으며, 유료 AI 계획이 없는 사용자에게 적합합니다.
• 초보자: 자연어를 통해 터미널 작업을 배우고 싶은 사람.
• 개인정보를 중시하는 개발자: 로컬 우선, 비용 없이 작동하는 코딩 에이전트를 원하는 사람.

주요 특징

• 제로 비용 및 오프라인: 네트워크 요구 없이 사용자 하드웨어에서 완전히 작동합니다.
• 교실 모드: 교사가 하나의 맥에서 모델 서버를 실행하고, 학생들이 LAN을 통해 연결할 수 있도록 합니다.
• RAM 인식 구성: 사용 가능한 시스템 메모리에 따라 모델 선택과 컨텍스트 길이를 자동 최적화합니다.
• 다중 엔진 지원: 여러 TUI 인터페이스와, 도구 호출 기능이 부족한 모델을 위한 XML 도구 호출 후행 기능을 갖춘 독립형 Python 엔진을 지원합니다.
• 하이브리드 연결: --auto 모드는 온라인 시 클라우드 기반 Claude Code, 오프라인 시 로컬 LLM으로 자동 전환합니다.