Decade-qiu/CookHero

해결하는 문제

CookHero는 요리와 건강 목표를 실행 가능한 일상 루틴으로 전환하는 개인 맞춤형 다이어트 관리 플랫폼입니다. 건강한 식사 계획의 어려움, 텍스트 또는 이미지에서 영양 섭취량을 추적하는 난이도, 특정 식이 제한 또는 건강 목표(예: 체중 감량, 혈당 조절)에 맞춘 전문적인 조리 지침을 찾는 어려움을 해결합니다.

작동 방식

이 시스템은 여러 고급 AI 아키텍처를 결합하여 영양 관리와 조리 작업을 통합적으로 처리합니다.

• 에이전트 워크플로우: 도구 허브와 전문 하위 에이전트 시스템을 갖춘 ReAct(추론 및 행동) 루프를 사용하여 자율적인 결정을 내리고 계획, 검색, 분석을 위한 도구를 호출합니다.
• 하이브리드 RAG: 벡터 검색(Milvus), 키워드 검색(BM25), 리랭커(Qwen3-Reranker 등)를 결합하여 글로벌 라이브러리 및 사용자가 업로드한 개인 요리책에서 정확한 레시피를 검색합니다.
• 다중 모달 처리: 업로드된 이미지에서 재료와 요리를 비전 모델로 식별하고, 이를 식사 기록 및 영양 추정 시스템에 피드합니다.
• 영양 추적: AI가 분석한 식사 기록에서 칼로리와 마크로 영양소를 자동 계산하고, 사용자가 설정한 목표와 비교합니다.
• 인프라 구조: FastAPI, React, PostgreSQL, Milvus, Redis를 사용한 풀스택 아키텍처로 구축되었습니다.

대상 사용자

• 전문적인 지도를 원하는 요리 초보자.
• 피트니스, 체중 감량, 혈당 관리에 집중하는 사람.
• 식품 알레르기 또는 특정 식이 요건이 있는 사람.
• 건강을 중시하며 주간 식사 계획과 추적을 체계적으로 원하는 사용자.

주요 특징

• 지능형 식사 관리 에이전트: Tavily를 통해 실시간 웹 검색을 수행하며, 식사 계획, 영양 분석을 담당하는 AI 에이전트.
• 자동 식사 기록: 텍스트 또는 이미지로 한 번의 클릭으로 식사 기록 가능. 칼로리와 마크로 영양소 자동 추정 기능 포함.
• 전문가 하위 에이전트 시스템: 내장형 및 사용자 정의 전문가 에이전트를 지원하며, 각각 독립된 시스템 프롬프트를 가집니다.
• RAG 품질 관리: RAGAS 프레임워크를 통합하여 충실도와 답변의 관련성 모니터링.
• 보안 레이어: NeMo Guardrails를 활용해 프롬프트 인젝션 방지, 요청 제한, 구조화된 감사 로그를 구현.
• MCP 지원: 모델 컨텍스트 프로토콜(MCP)과 호환되어 Amap과 같은 통합을 포함한 도구 확장이 가능합니다.