글

8월 16, 2026의 게시물 표시

M1 Mac Mini Local Mobile Web Coding Agent (Hermes & Ollama) Infrastructure Integration Issue Report

한국어 (KO) English (EN) 맥미니 M1 로컬 웹코더 에이전트 인프라 환경 구축 및 이슈 리포트 맥미니 M1 기본형(가용 VRAM 5.3 GiB) 하드웨어 한계를 극복하고 외부 SSD 공간 환경에서 로컬 모바일 웹 코딩 에이전트(Hermes Agent v0.20.1 + Ollama qwen2.5-coder:7b)를 안전하게 안착시키는 인프라 환경 구축 트래킹 및 파이프라인 검증 성공 내역입니다. 💡 핵심 요약: 에이전트 자율 구동 과정에서 발생한 OpenAI 프로바이더 명칭 충돌, Ollama 런타임 64K 컨텍스트 제한 장치 차단 및 .env 파일 내 텔레그램 연동 토큰 유실 위험 요소를 완벽히 진단·교정하여 무결점 로컬 빌드 정착에 성공했습니다. 🛠️ 4대 핵심 인프라 이슈 및 조치 사항 1. OpenAI 프로바이더 네이티브 호환성 충돌 해결 config.yaml에 provider를 'openai'로 지정 시 인식 차단 에러가 발생하여, Hermes 아키텍처에 내장된 로컬 매핑 포맷 규격인 'custom:custom'으로 정밀 수정하여 로컬 API 통로(http://127.0.0.1:11434/v1)를 완벽 개통했습니다. 2. Ollama 런타임 64K 컨텍스트 검문소 차단 우회 자율 도구 실행을 위해 최소 64K 토큰을 강제하는 에이전트 제한 장치를 우회하기 위해 제어판에 context_length와 ollama_num_ctx 수치를 모두 65536으로 강제 바인딩하여 VRAM 공간에 실시간 64K 버퍼를 예약 동기화했습니다. 3. .env 중요 자산 데이터 소멸 위험 차단 환경 설정 정비 과정 중 기존에 안전하게 작동하던 텔레그램 봇 토큰 및 채널 설정(TELEGRAM_BOT_TOKEN 등)이 초기화 구문으로 인해 소멸될 수 있었던 병목을 포착하여 파일 데이터를 100% 온전하게 보존 및 격리 처리 완료했습니다. 4...

Gemma × Hermes's study (RAG) construction strategy

한국어 (KO) English (EN) 비전공 홀로 개발을 학습하는 주니어 레벨러(Learner)분들을 위해, 로컬 AI 에이전트 시스템을 고도화하는 "젬마(Gemma) × 헤르메스(Hermes) 인공지능 비서를 위한 최고의 서재(RAG) 구축 전략"을 직관적으로 정리한 고찰 일지입니다. 🧠 1. 시스템의 본질: "컨닝페이퍼 합체 메커니즘" 우리가 구축할 백엔드 AI 파이프라인의 핵심 구동 원리는 제한된 자원 속에서 가성비를 극대화하는 것입니다. 나경우 레벨러의 요청서 (A4 반 장): "아이폰8 모바일 웹 렉 줄이는 법 알려줘"라는 실시간 사용자 질문. 헤르메스 비서의 컨닝페이퍼 (A4 반 장): 맥미니 서재에서 질문과 가장 연관성 높은 알짜배기 단서만 쏙 뽑아낸 문맥(Context) 조각. 젬마 판사의 트랜스포밍 (A4 1장 합체): 두 쪽지를 하나로 붙여 젬마 모델에 찌르면, 맥미니 M1의 RAM 과부하(렉)를 원천 차단 하면서 대기업 팀장급의 정확한 모바일 웹 소스코드가 출력됩니다. 📂 2. 문서 보관 규격: "통 파일 저장 ➔ 자동 토막" 데이터를 서재에 주입할 때 프로그래머가 아키텍처를 관리하는 정석적인 방법입니다. 나의 규칙 (원본 보관): 레퍼런스 북이 20쪽이든 200쪽이든 사람이 인위적으로 가위질할 필요가 없습니다. 문맥의 단절을 막기 위해 ‘온전한 원본 통 파일(.md 또는 .txt)’ 로 서재 폴더에 그대로 넣어둡니다. 헤르메스의 규칙 (자동 슬라이스): 거대 파일을 서재에 던져두면, 헤르메스 엔진이 백엔드에서 알아서 글자 수 기준 'A4 반 장짜리 조각(Chunk) 수백 개' 로 촘촘하게 자동 토막을 내고 디지털 바코드(Vector)를 붙여 보관합니다. 📚 3. 서재를 채우는 황금 비율: "레퍼런스 + 코딩 저널" 가장 똑똑한...

GitHub Codespaces Decision Guide for Self-Taught Developers

한국어 (KO) English (EN) 비전공 홀로 개발을 학습하는 주니어 레벨러(Learner)분들이 "내가 고른 깃허브 프로젝트를 코드스페이스(클라우드)에서 돌려도 될까?"를 직관적으로 판단할 수 있는 가이드라인입니다. ❌  코드스페이스에서 [못 쓰는] 코드 핵심 특징: 내 스마트폰에 '진짜 앱(App)'으로 설치되는 모바일 전용 네이티브 프로젝트 구분하는 키워드: iOS, Android, Swift, Kotlin, Flutter, React Native 왜 못 쓰나요?: 코드스페이스는 '리눅스 PC'입니다. 아이폰 앱을 만드는데 필요한 맥(macOS)이나 Xcode 프로그램이 설치되지 않기 때문에 실행 자체가 불가능합니다. 해외 개발자들의 README 문구 예시: "Open iOS/ in Xcode and run on a real device" (Xcode로 열어서 실제 기기에서 실행하세요) "Run on Android Emulator" (안드로이드 에뮬레이터에서 실행하세요) 해결책: 무조건 맥(Mac)이나 윈도우 PC 로컬 환경에서 직접 빌드해야 합니다. ⭕ 코드스페이스에서 [쓸 수 있는] 코드 핵심 특징: 크롬이나 사파리 같은 웹 브라우저(URL 주소)로 접속하는 웹 기반 프로젝트 구분하는 키워드: Next.js, React, HTML/JS, Gradio, Streamlit, Python Web UI 왜 좋나요?: 코드스페이스 클라우드 서버가 임시 웹사이트를 열어줍니다. 그 주소를 내 폰으로 접속하면 컴퓨터 사양이 낮아도, 심지어 똥폰이어도 AI 웹앱을 내 폰에서 마음껏 테스트할 수 있습니다. 실행 시 꼭 해야 하는 설정: 코드스페이스 하단 Ports 탭에서 포트 주소의 자물쇠를 우클릭하여 Private(나만 보기)에서 Public(전체 공개)으로...