학생을 위한 AI 학습 동반자 Shiori-v1

성적 관리에 진심인 학생들을 위한 AI 스터디 컴패니언입니다. 퀴즈, 플래시카드, 성적 추적, 그리고 공부 계획 기능을 하나의 앱에서 제공합니다. 사용자가 직접 무료 Gemini API 키를 가져와 사용할 수 있어 구독료가 필요 없습니다.

데모 체험하기 — 계정이나 API 키가 필요하지 않습니다.

• 노트 기반의 AI 퀴즈 생성 및 간격 반복 플래시카드 기능
• GPA 예측이 가능한 가중치 성적 계산기
• 마감일과 우선순위가 설정된 과제 관리자
• 실시간 미리보기가 가능한 Markdown 노트
• 작업과 연동되는 Pomodoro 집중 모드
• 강의 계획서(syllabus)를 기반으로 일별 학습 계획 생성 기능
• 습관 추적기, XP/레벨링 시스템, 친구 순위표
• 키보드 기반 탐색 ( g h, g a, g n, g q 등)

가장 빠른 방법: 데모를 열어 사용하세요.

직접 배포하기:

셀프 호스팅(Self-host):

git clone https://github.com/kaorii-ako/Shiori-v1.git
cd Shiori-v1
cp .env.example .env # Supabase URL + anon key 추가
...

AI 기능을 사용하려면 무료 Supabase 프로젝트(Settings → API에서 URL 및 anon key 필요)와 선택적으로 무료 Gemini API 키가 필요합니다.

프론트엔드는 React + Vite + Zustand를, 인증 및 데이터 관리는 Supabase를, AI 기능은 Gemini 1.5 Flash를 사용하여 (사용자 자신의 키로 클라이언트 측 호출), Vercel에 배포되었습니다.

Shiori-v1/
├── client/ React + Vite 프론트엔드
├── server/ Express 백엔드 (Stripe 웹훅 전용)
...

PR 환영합니다. 좋은 첫 이슈부터 시작하거나 CONTRIBUTING.md를 읽어보세요.

MIT 라이선스 — 원하는 방식으로 자유롭게 사용하세요.

Tawin Tangsukson이 제작했습니다. 유용하다면 별점을 눌러주세요.