FixIt AI: Google Gemma로 구동되는 오픈 웨이트 기술 문제 해결 친구

'AI에게 무엇이 잘못되었는지 묻지 마세요. AI가 스스로 찾아내도록 하세요.'

💡 배경 이야기: 누가 이 제품을 위해 만들었는가

태양광 발전이나 오프그리드(off-grid) 전기 장비를 사용하며 살아가는 것은 주체적이고 힘이 되어주지만, 어느 날 아무도 모르게 작동을 멈추는 일이 생기기도 합니다.

저는 작은 오프그리드 태양광 설비를 사용하는 가까운 친구를 위해 FixIt AI를 만들었습니다. 최근 그 친구의 휴대용 전력 스테이션이 한낮의 태양광 패널로부터 충전되지 않는 문제가 발생했습니다. 문제는 죽은 태양 전지(solar cell) 때문인지, 호환되지 않는 MPPT 컨트롤러 때문인지, 느슨한 케이블 때문인지, 아니면 위험한 문제인지를 그 친구는 전혀 알지 못했습니다.

그가 일반적인 폐쇄형 AI 챗봇에 질문을 했을 때, 이 챗봇은 18개의 밀도 높은 전기 관련 조언 목록을 한 번에 쏟아냈습니다. 제 친구는 질문하기 전보다 오히려 압도당하고 감전될까 봐 더 두려움을 느꼈습니다.

저는 그가 실제로 필요했던 것은 다음 기능을 가진 인내심 있는 기술 문제 해결 친구라는 것을 깨달았습니다:

무언가를 만지기 전에 안전을 먼저 평가하는 것.
모든 것을 안다고 가장하지 않으면서 구조화된 가설을 세우는 것.
한 번에 하나의 진단 테스트를 통해 안내해 주는 것.
안전한 DIY 점검과 면허가 있는 기술자가 필요한 위험 작업 사이를 구분하는 것.

이것이 제가 FixIt AI를 만든 이유입니다.

⚡ FixIt AI의 기능

표준적인 사진 → AI → 일반적인 긴 텍스트 벽 패턴 대신, FixIt AI는 상호작용하는 상태 기계(state machine)처럼 작동합니다:

Photo & Symptoms
      ↓
Safety Hazard Triage (Smoke / Thermal / Arcing)
...

주요 기능:

우선순위 안전 계층 (Priority Safety Layer): 아크 발생, 연기 또는 부풀어 오른 리튬 셀이 감지되면 DIY 테스트를 즉시 중단하고 구조화된 **기술자 인계 브리프(Technician Handover Brief)**를 생성합니다.
대화형 단계별 모드 (Interactive Step-by-Step Mode): 단일의 실행 가능한 점검 사항을 제공합니다 (예: 분해하기 전에 인라인 DC 차단기 검사).
멀티미터 지원 (Multimeter Support): 개방된 패널 터미널이나 소켓 핀 테스트 시 DC 전압 및 전류 판독값을 요청합니다.
순수 플랫 모던 UI (Pure Flat Modern UI): 언더라인이 없고, 순백색 타이포그래피를 사용하며 Lucide SVG 아이콘을 적용한 고대비의 블랙 & 에메랄드 모바일 우선 인터페이스(320px–480px 최적화)입니다.
증거 감사 로그 (Evidence Audit Log): 유지보수 기록이나 인계용으로 내보내기/인쇄 가능한 수리 타임라인을 생성합니다.

🧠 이 프로젝트에 오픈 소스 AI가 중요한 이유

Hacktoberfest 프롬프트는 다음과 같이 질문했습니다. 당신이 만든 것에 '오픈'이 왜 중요합니까?

FixIt AI의 경우, 오픈 웨이트 모델(Google Gemma 2)를 사용하는 것이 이 앱이 실제 환경에서 작동하는 근본적인 이유입니다:

1. 정전 = 인터넷 접속 불가

태양광 발전기나 가정 전기 시스템에 문제가 생길 때, 와이파이와 가정용 라우터가 함께 고장 나는 경우가 많습니다. 폐쇄형 클라우드 API(OpenAI, Claude)는 인터넷 연결이 없을 때는 완전히 쓸모가 없습니다. Gemma-2는 소비자 하드웨어(또는 Ollama를 통한 오프라인 노트북)에서 로컬로 실행되기 때문에, 제 친구는 인터넷 없이 정전 시 전력 장애 진단을 할 수 있습니다.

2. 가정 전기 인프라의 사생활 보호

문제 해결을 위해서는 차단기 분배 상자, 배선 경로, 일련번호 태그 등을 사진으로 찍어야 합니다. 주택 소유자는 자신의 집 물리적 구조에 대한 민감한 도면을 제3자 클라우드 서버에 업로드할 필요가 없습니다. 오픈 웨이트 모델은 이미지가 엄격하게 로컬 장치에 머무르도록 보장합니다.

3. 토큰 비용 0의 예측 가능한 JSON 스키마

대화형 문제 해결(Interactive troubleshooting)은 여러 번의 왕복 확인 과정(세션당 5~10회 추론 단계)을 필요로 합니다. 매번 작은 테스트를 위해 독점 API(proprietary APIs)를 호출하는 것은 비용적으로 불가능합니다. Gemma의 강력한 지시 이행 능력(instruction-following)은 $0.00의 한계 비용으로 엄격한 JSON 스키마 유효성 검사를 가능하게 합니다.

🛠️ 기술 스택 및 아키텍처 (Tech Stack & Architecture)

AI 모델: Google Gemma 2 (gemma2-9b-it를 Groq을 통해 고속 클라우드 추론으로 사용하며, 100% 오프라인 엣지 추론을 위한 네이티브 Ollama 지원).
프런트엔드 및 앱 프레임워크: Next.js (App Router, Turbopack, React 19, TypeScript).
디자인 시스템: 검은색과 에메랄드 색상 팔레트를 사용한 플랫 바닐라 CSS(Flat Vanilla CSS)와 선명한 타이포그래피, Lucide 아이콘.
배포: 네이티브 render.yaml 블루프린트(Blueprint)를 사용하여 Render에 호스팅됨.

🔗 라이브 데모 및 링크 (Live Demo & Links)

💻 GitHub 저장소: github.com/kayode96-max/hacktoberfest_fixit
⚙️ Render 블루프린트: https://fixit-ai-1hz8.onrender.com

Hacktoberfest 주말 챌린지(Build for a Friend #hf26challenge)에 제출됨.