Nutlope/receipthero

ReceiptHero는 AI 기반 OCR(광학 문자 인식)을 사용하여 영수증을 관리하는 데 도움이 되는 오픈소스 웹 앱입니다. 영수증 이미지에서 텍스트를 읽어 구조화된 데이터로 변환한 다음 지출 내역을 표시합니다. 앱은 완전히 브라우저에서 실행되며, 데이터는 개인정보 보호를 위해 로컬에 유지됩니다.

작동 방식

1. 영수증 이미지를 끌어서 놓거나 파일을 선택하여 업로드합니다.
2. 이미지는 Together AI의 Qwen3.5 비전 모델로 전송되어 OCR(텍스트 읽기)을 수행합니다.
3. 모델은 구조화된 세부 정보(판매처, 날짜, 금액, 항목, 통화, 결제 수단)를 추출합니다.
4. 지출은 자동으로 분류됩니다(예: 식료품, 외식, 주유).
5. 지출 내역과 영수증 관리 인터페이스가 표시됩니다.
6. 모든 데이터는 브라우저 로컬에 저장되며 서버로 전송되지 않습니다.

기술 스택(README에서)

• Next.js(App Router) 및 Tailwind CSS를 사용한 프론트엔드
• Together AI를 사용한 LLM 기반 OCR
• Qwen3.5 9B를 사용한 영수증 데이터 추출
• shadcn/ui 컴포넌트 및 Radix UI
• Zod를 사용한 데이터 검증

로컬 실행

1. 리포지토리를 포크하거나 클론합니다.
2. Together AI에서 계정을 만들어 OCR 서비스용 API 키를 받습니다.
3. .env 파일을 만들고(.example.env를 템플릿으로 사용) API 키를 추가합니다.
4. npm install을 실행한 다음 npm run dev를 실행하여 종속성을 설치하고 개발 서버를 시작합니다.

참고: README에는 위에 나열된 것 외의 다른 기능은 언급되지 않았습니다. 이 앱은 Together AI로 구동되며 OCR 모델은 Qwen3.5 9B입니다.