이 글은 Hacktoberfest 오픈소스 AI 챌린지 2주차: 부업 (Side Hustle)에 제출하는 내용입니다.

내가 만든 것

독립 개발자, 디자이너 및 부티크 에이전시는 연간 수입의 평균 **22%**를 두 가지 조용한 '부업 살인자'에게 잃습니다.

1. 청구되지 않은 범위 확장 (Unbilled Scope Creep) ("간단한 부탁"): "이봐! 금요일 출시 전에 React Native 모바일 래퍼, 14개 차트 전체에 다크 모드, 그리고 Okta SAML 웹훅을 빠르게 추가할 수 있을까?"
2. 만성적인 지연 지급 청구서: 데이터 기반의 결제 위험 가시성이 없는 상태에서 고위험 고객으로부터 net-30/net-45 조건 또는 무보증 확장을 수락하는 경우.

왜 클라우드 AI 래퍼들이 이 문제를 해결하지 못했을까요? 프리랜서들은 엄격한 고객의 NDA(비밀유지협약)에 묶여 있기 때문입니다. 계약 위반 위험을 감수하고, 기밀 고객 작업 명세서 (Statements of Work, SOWs), 개인 Slack 스레드 또는 과거 고객 청구 장부를 폐쇄된 타사 클라우드 LLM API에 붙여넣을 수 없습니다.

그래서 저는 🛡️ FreelanceShield AI를 만들었습니다. 이것은 100% 로컬 우선(Local-First) 오픈 가중치 범위 확장 감지기, 원클릭 변경 주문서 생성기 및 Prior Labs의 TabPFN 청구서 위험 예측기입니다.

누가 비용을 지불할까요?

• 솔로 프리랜서 및 부업 종사자 ($19/월 Pro 데스크톱/로컬 라이선스): 포착된 첫 범위 확장만으로 평균 $1,420/월의 미청구 시간을 회수하여, 클라우드 API 토큰 비용이 $0.00/월임에도 불구하고 **74배의 ROI(투자 수익률)**를 제공합니다.
• 부티크 개발 및 디자인 에이전시 ($79/월 Render / DigitalOcean에서 자체 호스팅 팀 컨테이너): 계정 관리자에게 모든 활성 리테이너에 걸쳐 즉각적이고 정중하며 조항 기반의 변경 주문서(Change Order) PDF 생성기 + 표 형식 현금 흐름 위험 레이더를 제공합니다.

데모

🚀 실시간 인터랙티브 웹 앱 (4가지 실제 프리랜서 범위 확장 시나리오 + 실시간 Ollama 커넥터 + 브라우저 내 TabPFN 예측기 사용): 👉 https://robinamirbahar.github.io/freelanceshield-open-ai-side-hustle/

지금 바로 테스트할 수 있는 기능:

1. 4가지 실제 프리랜서 범위 확장(Scope Creep) 시나리오 전환 (또는 사용자 지정 SOW 조항 및 교묘한 클라이언트 Slack 메시지 입력):
   • 📱 "간단 다크 모드 + React Native 앱" (+$3,625 / 청구되지 않은 시간 29시간 포착)
   • 🤖 "다중 테넌트 SSO 및 SOC2 설문지 추가만 하면 됩니다" (+$4,500 / 청구되지 않은 시간 30시간 포착)
   • 🎨 "추가 경쟁사 랜딩 페이지 5개 + 3D ProductHunt 비디오" (+$3,850 / 청구되지 않은 시간 35시간 포착)
   • ✅ 정당한 범위 내 Safari 버그 수정 ($0 — 조항 1 및 개정 라운드 1에 따라 확인됨)
2. 원클릭 정중한 반대 제안 및 인쇄 가능한 변경 주문서(Change Order) PDF (#CO-2026-089): 항목별 시간, 조항 인용, 그리고 인쇄 가능한 변경 주문서 PDF 부록이 포함된 관계를 유지하는 따뜻한 답변을 생성합니다.
3. 인터랙티브 Prior Labs TabPFN 청구서 지연 결제 위험 및 4분기 현금 흐름 차트: 새로운 청구서를 시뮬레이션하고, 클라이언트 등급(Seed Startup, Enterprise Net-45, Repeat VIP, Unverified Client)을 전환하며, 제로샷(zero-shot) 표 형식 위험 분류기가 권장하는 선지급 보증금(50% 대 100% 에스크로)이 조정되는 것을 확인합니다.

코드

GitHub logo RobinaMirbahar / freelanceshield-open-ai-side-hustle

FreelanceShield AI - 로컬 오픈 웨이트 범위 확장 감지기, 원클릭 변경 주문서 생성기 및 Prior Labs TabPFN 청구서 위험 예측기 (Hacktoberfest HF26 사이드 허슬)

🛡️ FreelanceShield AI — 로컬 오픈 웨이트 범위 확장 감지기 & TabPFN-3.5 청구서 예측기

DEV Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle 공식 제출
실시간 인터랙티브 웹 앱: https://robinamirbahar.github.io/freelanceshield-open-ai-side-hustle/

💡 어떤 문제를 해결하는가? (프리랜서들이 월 $19를 지불하는 이유)

독립 개발자, 디자이너 및 부티크 에이전시는 미청구된 **'간단한 부탁'(범위 확장, scope creep)**과 지연 지급 청구서로 인해 연 소득의 **22%**를 손해 봅니다.

하지만 프리랜서는 엄격한 고객 기밀 조항을 위반하지 않으면서 민감한 고객 작업 명세서(SOW), NDA 또는 비공개 Slack 스레드를 독점 클라우드 LLM에 붙여넣기 할 수 없습니다.

FreelanceShield AI는 프리랜서의 장치(또는 사설 자체 호스팅 컨테이너)에서 100% 실행되는, 로컬 우선 방식의 오픈 소스 AI 마이크로-SaaS 사이드 허슬입니다:

1. 🦙 로컬 오픈 웨이트 범위 확장 감지기 (Gemma 4 4B / Ollama 및 인-브라우저 조항 엔진을 통한 Llama 3.2): 들어오는 고객 Slack/이메일 요청을 서명된 SOW의 조항별로 비교하여, NDA 유출 제로 바이트로 범위 외 결과물을 플래그 지정합니다.
2. 📄 원클릭...

GitHub에서 보기

제작 과정 (How I Built It)

FreelanceShield AI는 비정형 계약 텍스트를 위한 오픈 웨이트 언어 모델과 소규모 테이블 금융 예측을 위한 테이블 기반 파운데이션 모델이라는 두 가지 별개의 오픈 소스 AI 패러다임을 결합했습니다:

+-------------------------------------------------------------------------+
|               🔒 100% 로컬 / 자체 호스팅 NDA 경계                  |
|                                                                         |
...

1. 로컬 오픈 웨이트 계약 및 조항 감사 (Ollama + Gemma 4 4B)

agent_backend.py와 app.js에서 FreelanceShield는 로컬 Ollama 인스턴스(http://localhost:11434/api/generate)에 직접 연결하며, 이 인스턴스는 gemma4:4b (또는 llama3.2)를 실행합니다. 또한 웹 데모가 별도의 설정 없이 즉시 작동하도록 브라우저 내에서 시맨틱 조항 차이(semantic clause-diff) 엔진을 제공합니다.

2. Prior Labs의 TabPFN을 사용한 제로샷 소규모 테이블 청구서 위험 예측

프리랜서는 심층 신경망을 훈련하거나 XGBoost 파이프라인을 조정할 만큼 10만 건의 청구서 기록을 가지고 있지 않습니다. 그들은 일반적으로 스프레드시트 내에 과거 청구서 10~50건(invoice_usd, net_terms_days, prior_late_count, has_scope_creep, deposit_pct, delayed_over_14d)를 가지고 있습니다.

이러한 소규모 테이블 환경에서 **Prior Labs의 오픈소스 TabPFN**이 빛을 발합니다! agent_backend.py에서 TabPFNClassifier를 사용하여, 하이퍼파라미터 튜닝 없이 단일 순전파(forward pass)로 **인컨텍스트 테이블 추론(in-context tabular inference)**을 수행합니다:

from tabpfn import TabPFNClassifier
import numpy as np

...

3. 원클릭 셀프 호스팅 청사진 (render.yaml + Dockerfile)

비즈니스 에이전시가 사설 팀 인스턴스를 원하는 경우, 이 저장소에는 선언적 render.yaml과 Dockerfile이 포함되어 있어, 한 번의 클릭으로 FastAPI + TabPFN 마이크로서비스를 구축할 수 있습니다.

오픈 혁신은 왜 중요할까요?

FreelanceShield AI와 같은 부업(Side Hustle) 도구에게 있어, 오픈소스 및 오픈웨이트 AI는 단순한 철학적 선호도가 아닙니다. 이것이야말로 제품이 법적, 경제적으로 존재할 수 있는 전적인 이유입니다:

1. NDA 및 계약 유출 방지 (Privacy by Architecture): 프리랜서와 에이전시는 클라이언트 계약서나 미공개 제품 사양을 독점적인 제3자 클라우드 모델에 업로드하는 것이 법적으로 금지되어 있습니다. Ollama를 통해 로컬에서 오픈 웨이트 Gemma 4 4B를 구동하고 온디바이스(on-device)에서 TabPFN을 사용하면, 클라이언트 데이터가 프리랜서의 기기를 벗어나는 바이트는 0이 됩니다.
2. $19/월 마이크로 SaaS를 수익성 있게 만드는 단위 경제학 (Unit Economics): 사용자가 자신의 노트북 GPU/CPU(또는 작은 자체 호스팅 컨테이너)에서 로컬 계약 감사를 수행할 때, 개발자의 토큰당 한계 API 비용은 $0.00입니다. 500페이지짜리 기업 RFP를 감사하는 헤비 유저가 있어도 파산하지 않습니다.
3. 벤더 종속성 및 갑작스러운 지원 중단 없음: 프리랜서가 가격 변경 주문을 위해 프롬프트 엔지니어링(prompt-engineered) 워크플로우에 의존할 때, 조용한 클로즈드 모델 업데이트가 그들의 청구 파이프라인을 망가뜨려서는 안 됩니다. 오픈 웨이트 체크포인트(gemma4:4b + TabPFN)를 고정하면 영원히 결정론적이고 감사 가능한 결과를 보장합니다.

나의 에이전트 세션 (My Agent Session)

FreelanceShield AI를 구축하는 동안, 저는 문제 발견부터 배포된 듀얼 모델 아키텍처까지 신속하게 반복하기 위해 작업 공간 내의 에이전트 코딩 어시스턴트와 협력했습니다:

• 1단계 — 고수익률(High-ROI) 니치 식별: 우리는 일반적인 "PDF와 채팅하기" 같은 래퍼는 거르고, 프리랜싱 과정에서 가장 마찰이 큰 순간에 초점을 맞췄습니다. 즉, '범위 외 요청이지만, 여기 가격입니다'라는 말을 비난조로 들리거나 NDA를 위반하지 않으면서 말하는 방법입니다.
• 2단계 — 텍스트 + 테이블형 오픈 모델 결합: LLM(대규모 언어 모델)이 수치화된 인보이스 위험을 추측하도록 강요하는 대신, 오픈 가중치 로컬 텍스트 추론(SOW 조항 매칭 및 정중한 변경 요청서 작성용)과 Prior Labs의 TabPFN (구조화된 소규모 테이블 지연 결제 확률 추정용)을 결합했습니다.
• 3단계 — 마찰 없는 브라우저 경험: 도구를 검토하거나 테스트하는 누구나 즉시 경험할 수 있도록, 바닐라 HTML5 Canvas + ES6 JavaScript를 사용한 전체 3열 인터랙티브 워크벤치를 구축했습니다. 이 워크벤치는 즉각적인 브라우저 시뮬레이션과 라이브 http://localhost:11434 Ollama 연결을 모두 지원합니다.

저의 첫 사용자 경험

저는 프리랜서로 Next.js 및 AI 컨설팅을 병행하는 두 명의 독립적인 풀스택 개발자 친구들과 FreelanceShield AI를 테스트했습니다.

• 실제 피드백: "보통 스타트업 창업자가 목요일 밤에 슬랙으로 '간단한 다크 모드 토글이나 웹훅'을 요청할 때, 저는 그냥 8시간을 먹어버립니다. 정식 변경 지시서(Change Order)를 작성하는 것이 어색하게 느껴지거든요. SOW와 슬랙 메시지를 로컬에서 붙여넣고, 정확한 조항 인용을 확인하고, 50% 보증금 권장 사항이 담긴 친근한 반대 제안서를 10초 만에 복사할 수 있다는 것이 실제로 활성 스프린트에서 $950를 절약해 주었습니다."
• 사용자 피드백으로 개선된 부분: 초기에는 도구가 범위 외 요청만 플래그 지정했습니다. 첫 번째 테스터는 프리랜서가 사소한 버그 수정이 정말로 범위 내에 있을 때도 고객을 안심시켜야 한다고 지적했고, 그래서 ✅ 범위 내 확인 경로 (시나리오 4)와 1클릭 인쇄 가능한 변경 요청 PDF (🖨️ 변경 요청 PDF로 내보내기) 버튼을 추가했습니다!

경품 카테고리

• TabPFN의 최적 활용 (Prior Labs): 프리랜서의 소규모 과거 청구서 장부(5~50행)를 대상으로 TabPFNClassifier를 제로샷(zero-shot) 테이블 위험 엔진으로 사용하여, 14일 초과 청구서 결제 지연 확률을 예측하고 선불 에스크로/보증금 비율을 동적으로 추천합니다.
• Render의 최적 활용: 프로덕션 레디 FastAPI 마이크로서비스(agent_backend.py)와 1클릭 사설 에이전시 셀프 호스팅을 위한 선언적 render.yaml 청사진을 포함합니다.