rextanka/zero-cost-cline

클라우드 비용이나 API 키 없이 온디바이스에서 사적인 AI 지원 코딩 에이전트 워크플로우를 구축, 테스트 및 실행하세요.

이 저장소는 Apple Silicon Mac에서 완전히 로컬이고 사적인 AI 소프트웨어 엔지니어링 에이전트를 구성하기 위한 포괄적이고 단계별 설정 가이드와 기술 워크스루를 담고 있습니다.

Ollama(모델 서버)와 Cline(고급 VS Code 에이전트 확장)를 결합하여, 이 가이드는 최첨단 모델 구독 및 API 페이월에서 벗어나는 방법을 보여줍니다. 여러분은 로컬 추론 하드웨어에 정확하게 맞춰진 고도로 규율 잡힌, 인간 참여형(human-in-the-loop) 에이전트 워크플로우를 구성하게 됩니다.

🚀

코드를 찾고 계신가요? 이 가이드를 따라 구축된 완전한 작동 참조 구현체는 https://github.com/rextanka/avi-tree-tutorial-result.git에서 찾을 수 있습니다.

API 비용 제로: 반복적인 비용 없이 고급 에이전트 소프트웨어 엔지니어링을 실험하고 싶은 개발자, 학생 및 취미가에게 완벽합니다.100% 사적이며 오프라인: 모든 것이 온디바이스에서 완전히 실행됩니다. 코드 조각이나 데이터는 절대 여러분의 기기를 벗어나지 않습니다.실제 하드웨어에 맞춰 조정됨: 이 가이드는 두 가지 기준 구성에 대해 엄격하게 조정되었습니다: 24GB 통합 메모리(예: MacBook Air M4)에서 효율적인 밀집 모델(dense models) 실행. 48GB 통합 메모리(예: MacBook Pro M4 Pro)에서 고급 코딩 Mixture-of-Experts (MoE) 모델 실행.

로컬 모델의 결함 완화: 로컬 9B–12B 모델은 때때로 루프에 빠지거나 터미널 명령을 환각(hallucinate)할 수 있습니다. 이 가이드는 에이전트가 엄격하게 규율을 유지하도록 명시적인 .clinerules와 강력한 Git 체크포인트 전략을 제공합니다.

튜토리얼은 다음 기능을 갖춘 최고 수준의 개발 환경을 구현합니다:

동반 가이드에서는 구조화되고 다단계의 설정 및 실습 과제를 안내합니다:

Homebrew, CMake, Python, VS Code, Xcode 명령줄 도구에 대한 단계별 설치 지침.

적절한 컨텍스트 창(num_ctx), 결정론적 코드 생성을 위한 낮은 온도, 그리고 성가신 콜드 스타트 재로드 지연을 방지하기 위한 keep-alive 매개변수(OLLAMA_KEEP_ALIVE=-1)를 구성하는 지속적인 Modelfile 작성 방법 학습.

**Act-mode 인간 참여 루프(human-in-the-loop workflow)**를 엄격하게 사용하도록 Cline 설정을 구성하고 (로컬 모델 실패 루프 방지) 에이전트가 파일 시스템 전체에서 무분별하게 실행되는 것을 막는 로컬 .clinerules 파일을 부트스트랩합니다.

설정이 작동하는지 증명하기 위해, 로컬 LLM을 엄격한 테스트 주도 개발(TDD) 접근 방식을 사용하여 처음부터 C++로 완전한 AVL Tree를 구축하도록 안내할 것입니다:

Phase I (인프라): 에이전트에게 디렉터리 계층 구조를 설정하고 깔끔한 CMake 구조를 컴파일하도록 지시하는 것.
Phase II (인터페이스 및 테스트 스캐폴딩): 구현 코드가 존재하기 전에 엄격한 공개 C++ 헤더 계약을 작성하고 단위/기능 테스트를 설정하는 것.
Phase III (구현 및 검증): 자동화된 테스트 실행을 결정론적 평가 하니스로 사용하여, 모델이 복잡한 자체 균형 트리 포인터 회전 로직을 거치도록 안내하는 것.

• 이 저장소를 Apple Silicon Mac에 클론하세요.
• 포함된 local-llm-cline-tutorial.md 튜토리얼 문서를 여세요.

이 전제 조건들을 따라 로컬 환경을 설정하고 무료로 코딩을 시작하세요!

새로운 Apple Silicon 칩에 대한 기여, 피드백 및 모델 성능 벤치마킹 업데이트는 언제나 환영합니다!