문서 | 빠른 시작 | 토론 | 기여하기

🇬🇧 English | 🇯🇵 日本語 | 🇨🇳 中文 | 🇰🇷 한국어 | 🇪🇸 Español | 🇫🇷 Français | 🇩🇪 Deutsch | 🇧🇷 Português | 🇸🇦 العربية | 🇧🇩 বাংলা | 🇮🇳 हिन्दी | 🇷🇺 Русский

Studyield는 개인화된 콘텐츠, 지능형 튜터링, 적응형 평가를 통해 학생들이 더 효과적으로 학습할 수 있도록 돕는 오픈 소스 AI 기반 학습 플랫폼입니다. 학생, 교육자, 평생 학습자를 위해 구축된 Studyield는 최첨단 AI 기술과 검증된 학습 과학을 결합합니다.

콘텐츠 전달에만 집중하는 전통적인 학습 플랫폼이나 포괄적인 학습 기능이 부족한 AI 튜터링 도구와 달리, Studyield는 6개의 강력한 AI 기능, 완전한 학습 도구 키트, 멀티 플랫폼 액세스를 갖춘 완전한 학습 생태계를 제공합니다.

Studyield의 AI 기반 학습 대시보드

1. 자료 업로드 -- 학습 자료(PDF, 문서, 기출문제)를 지식 베이스에 추가
2. AI 분석 및 정리 -- AI가 핵심 개념을 추출하고 지식 그래프를 구축하며 검색 가능한 임베딩을 생성
3. 연습 및 학습 -- 모의고사를 생성하고, 멀티 에이전트 AI로 문제를 해결하고, 플래시카드로 퀴즈
4. 피드백 받기 -- 티치백 평가를 사용하여 이해도를 테스트하고 지식 격차를 식별
5. 진행 상황 추적 -- 분석을 통해 학습 속도, 숙달 수준, 학습 패턴 모니터링

• 🎯 시험 복제 -- 기출문제를 업로드하고 동일한 스타일, 난이도, 형식의 새로운 연습 문제를 생성
• 🤖 멀티 에이전트 문제 해결사 -- 분석, 솔루션, 검증 에이전트가 협력하여 실시간 스트리밍으로 복잡한 문제를 해결
• 🕸️ 지식 그래프 -- 학습 자료에서 엔티티와 관계를 자동 추출하여 대화형 시각화로 구현
• 🎙️ 티치백 평가 -- 학생이 개념을 설명(텍스트/음성)하면 AI가 파인만 기법을 사용하여 이해도를 평가
• 🔬 심층 연구 모드 -- 업로드된 자료의 RAG + 웹 검색으로 인용이 포함된 구조화된 보고서를 생성
• 💻 코드 샌드박스 -- NumPy, Pandas 및 과학 라이브러리를 지원하는 안전한 Python 실행
• 📚 지식 베이스 -- 의미론적 검색 및 RAG를 위한 문서(PDF, DOCX) 업로드
• 🃏 간격 반복 시스템 플래시카드 -- 최적의 암기를 위한 간격 반복 시스템
• 📝 AI 생성 퀴즈 -- 학습 자료에서 자동 퀴즈 생성
• 💬 RAG 채팅 -- 문서의 인용이 포함된 대화형 AI
• 🗺️ 학습 경로 -- AI가 생성한 최적의 학습 경로
• 📊 진행 상황 분석 -- 학습 시간, 숙달 수준, 학습 속도 추적
• 🌍 12개 언어 -- 완전한 i18n 지원(EN, JA, ZH, KO, ES, FR, DE, PT, AR, BN, HI, RU)
• 📱 Web + 모바일 -- React 프론트엔드 및 Flutter 모바일 앱

AI 채팅 -- 업로드한 학습 자료에 기반한 질문에 문서 인용이 포함된 답변

오늘날의 학생들은 정보에 익사하고 있지만 효과적인 학습 도구에는 굶주려 있습니다. 전통적인 학습 방법은 시간이 오래 걸리고 비효율적이며, 기존 AI 튜터링 솔루션은 너무 비싸거나 제한적이거나 데이터를 독점 플랫폼에 업로드해야 합니다.

우리가 해결하는 일반적인 문제점:

• ❌ 일반 연습 자료 -- 기성 문제 은행은 실제 시험 스타일이나 난이도와 일치하지 않음
• ❌ 고립된 학습 도구 -- 플래시카드, 퀴즈, 노트가 여러 앱에 흩어져 있음
• ❌ 깊은 이해 검증 없음 -- 진정으로 이해했는지 아니면 단순히 암기했는지 알 수 없음
• ❌ 수동 지식 정리 -- 노트 정리 및 개념 연결에 몇 시간을 낭비
• ❌ 제한된 AI 튜터링 -- 대부분의 AI 튜터는 문제 해결 단계나 검증을 보여주지 않고 답만 제공
• ❌ 개인 정보 보호 우려 -- 학습 자료를 폐쇄 소스 플랫폼에 업로드
• ❌ 높은 비용 -- 프리미엄 AI 학습 도구는 학생당 월 20~50달러 소요

✅ 시험 스타일 연습 -- 실제 시험을 복제하여 완벽하게 일치하는 연습 문제를 생성

✅ 올인원 플랫폼 -- 지식 베이스, 플래시카드, 퀴즈, 채팅, 연구, 분석이 한곳에

✅ 깊은 이해 -- 티치백 평가 및 멀티 에이전트 문제 해결로 진정한 이해 보장

✅ 자동 지식 그래프 -- AI가 자료에서 개념을 자동으로 추출하고 연결

✅ 고급 AI 기능 -- 멀티 에이전트 해결, 심층 연구, 코드 실행, 실시간 스트리밍

✅ 자체 호스팅 및 오픈 소스 -- 자체 인프라에서 실행, 데이터에 대한 완전한 제어

✅ 무료로 시작 -- Docker 배포가 포함된 오픈 소스, 공정한 가격의 선택적 호스팅 버전

멀티 에이전트 문제 해결사 -- 분석, 해결, 검증 에이전트가 실시간으로 협력하여 복잡한 문제를 분해하고 검증

1. 완전한 AI 학습 생태계 -- 6개의 고급 AI 기능(시험 복제, 멀티 에이전트 해결, 지식 그래프, 티치백, 연구, 코드 샌드박스)이 전통적인 학습 도구(플래시카드, 퀴즈, 노트)와 통합
2. 멀티 에이전트 아키텍처 -- 문제 해결 및 검증을 위한 협업 AI 에이전트를 갖춘 최초의 오픈 소스 학습 플랫폼
3. 자체 호스팅 + 오픈 소스 -- 독점 플랫폼과 달리 Docker 배포를 통해 데이터를 완전히 제어
4. 시험 중심 설계 -- 일반 문제 은행이 아닌 실제 테스트 형식과 일치하는 모의고사 생성
5. 깊은 이해에 중점 -- 티치백 평가 및 다단계 검증을 통해 단순한 암기가 아닌 진정한 이해 보장

Studyield는 성장하는 커뮤니티가 있는 적극적으로 유지 관리되는 프로젝트입니다. 현재 상황은 다음과 같습니다:

지표	상태	세부 정보
총 기여자 수		성장하는 개발자 커뮤니티
총 커밋 수		2024년 이후 활발한 개발
월간 커밋 수		정기적인 업데이트 및 개선
평균 PR 검토 시간	24-48시간	유지 관리자의 빠른 피드백
코드 품질		TypeScript + ESLint + Prettier
테스트 커버리지		백엔드 단위 + 통합 테스트
문서		전체 API 문서 + 개발자 가이드

• ✅ 2026년 4월 -- 첫 오픈 소스 릴리스
• ✅ 27개 백엔드 모듈 -- auth, ai, content, exam-clone, problem-solver, teach-back, research, code-sandbox 등
• ✅ 120개 이상의 API 엔드포인트 -- 포괄적인 REST + WebSocket API
• ✅ 12개 언어 -- 완전한 국제화 지원
• ✅ 3개 플랫폼 지원 -- Web(React), 모바일(Flutter), API
• ✅ Docker 배포 -- 원클릭 자체 호스팅

활발한 개발 -- 정기적인 커밋 및 업데이트로 버그가 빠르게 수정되고 커뮤니티 피드백을 기반으로 기능이 추가됩니다

빠른 PR 검토 -- 24-48시간 검토 시간은 귀하의 기여가 유지 관리자의 주목을 기다리며 유휴 상태가 되지 않음을 의미합니다

높은 코드 품질 -- TypeScript, ESLint, Prettier 및 포괄적인 테스트로 안정적이고 유지 관리 가능한 코드베이스 보장

포괄적인 문서 -- 전체 API 문서, 개발자 가이드 및 코드 주석으로 원활한 온보딩 가능

성장하는 커뮤니티 -- 더 많은 기여자는 더 많은 기능, 더 나은 테스트, 제품 방향에 대한 다양한 관점을 의미

여기에서 귀하의 기여를 보고 싶으신가요? 아래의 빠른 기여 가이드를 확인하세요!

프로젝트 루트에서 다음 명령을 실행:

git clone https://github.com/studyield/studyield.git
cd studyield
cp backend/.env.example backend/.env
# 데이터베이스 자격 증명 및 OpenRouter API 키로 backend/.env 편집
docker compose --env-file .env.docker up -d

이게 전부입니다! http://localhost:5189에서 앱에 액세스하고 http://localhost:3010에서 API에 액세스합니다.

전제 조건: Node.js 20+, PostgreSQL 15+, Redis 7+

# 클론
git clone https://github.com/studyield/studyield.git
cd studyield

# 백엔드
cd backend
cp .env.example .env    # 구성으로 .env 편집
npm install
npm run migrate
npm run start:dev

# 프론트엔드 (새 터미널에서)
cd frontend
cp .env.example .env
npm install
npm run dev

http://localhost:5189를 방문하여 앱에 액세스합니다.

./start.sh

이렇게 하면 Docker를 통해 PostgreSQL, Redis, Qdrant 및 ClickHouse가 시작된 다음 백엔드 및 프론트엔드 개발 서버가 시작됩니다.

┌─────────────────────────────────────────────────────────────────┐
│                       Studyield Platform                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────────┐     ┌──────────────┐     ┌──────────────┐     │
│  │   React Web  │     │   Flutter    │     │  REST + WS   │     │
│  │  (Frontend)  │     │    Mobile    │     │     API      │     │
│  └──────────────┘     └──────────────┘     └──────────────┘     │
│                                                                 │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │               NestJS Backend (27 Modules)                 │  │
│  ├───────────────────────────────────────────────────────────┤  │
│  │  Auth │ AI │ Exam Clone │ Problem Solver │ Chat           │  │
│  │  Teach-Back │ Research │ Knowledge Graph │ Quiz           │  │
│  │  Flashcards │ Learning Paths │ Analytics │ ...            │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                 │
│  ┌───────────┐   ┌───────────┐   ┌───────────┐   ┌───────────┐  │
│  │PostgreSQL │   │   Redis   │   │  Qdrant   │   │ClickHouse │  │
│  │(Core Data)│   │(Cache+MQ) │   │ (Vectors) │   │(Analytics)│  │
│  └───────────┘   └───────────┘   └───────────┘   └───────────┘  │
│                                                                 │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │  External Services: OpenRouter, OpenAI, Cloudflare R2,    │  │
│  │  AWS SES, Firebase, Stripe                                │  │
│  └───────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

프론트엔드 (/frontend) -- React 19, Vite, TypeScript, Tailwind CSS, Radix UI (shadcn), Zustand, React Query, i18next

모바일 (/mobile) -- Flutter 3.10+, Provider + BLoC, Dio, Go Router, Firebase, Easy Localization

백엔드 (/backend) -- NestJS 10, TypeScript, PostgreSQL (raw SQL), Redis, Qdrant, ClickHouse, BullMQ, Socket.io

Studyield는 i18next(프론트엔드) 및 Easy Localization(모바일)을 통해 12개 언어를 지원합니다:

• English, 日本語, 中文, 한국어, Español, Français, Deutsch, Português, العربية, বাংলা, हिन्दी, Русский

새로운 언어를 추가하고 싶으신가요? 번역 가이드를 참조하세요.

Studyield는 단순한 또 다른 오픈 소스 프로젝트가 아닙니다 -- AI 기반 교육의 미래를 구축하고 전 세계 수백만 명의 학생들에게 양질의 학습을 제공할 수 있는 기회입니다.

📚 현대적인 기술 스택 학습

• NestJS + TypeScript -- 의존성 주입 및 모듈식 설계를 갖춘 엔터프라이즈급 백엔드 아키텍처
• React 19 + Vite -- 초고속 빌드를 갖춘 최신 React 기능
• Flutter -- iOS 및 Android용 크로스 플랫폼 모바일 개발
• AI/ML 통합 -- LLM, 임베딩, 벡터 데이터베이스 및 멀티 에이전트 시스템 사용
• 실시간 시스템 -- WebSocket, 스트리밍 및 이벤트 기반 아키텍처
• DevOps -- Docker, CI/CD, 자체 호스팅 및 Infrastructure as Code

💼 포트폴리오 구축

• 전 세계 학생들이 사용하는 프로덕션 준비 플랫폼에 기여
• GitHub 프로필에 표시되는 기능 작업
• 기여자 명예의 전당에서 인정받기
• AI 기반 교육 및 EdTech 전문 지식 구축 -- 2026년에 높이 평가되는 기술

🤝 성장하는 커뮤니티 참여

• 전 세계 개발자와 연결
• 경험 많은 유지 관리자로부터 코드 리뷰 받기
• 소프트웨어 아키텍처의 모범 사례 학습
• 기술 토론 및 설계 결정에 참여

🎯 실질적인 영향 만들기

• 귀하의 코드는 학생들이 더 효과적으로 학습하고 학업 목표를 달성하는 데 도움이 됩니다
• 프로덕션 환경에서 사용되는 기능 보기
• 오픈 소스 EdTech의 방향에 영향을 미치기

⚡ 빠른 온보딩

• Docker Compose로 5분 이내에 실행 가능
• 명확한 아키텍처를 갖춘 잘 문서화된 코드베이스
• 24-48시간 이내에 PR에 응답하는 친절한 유지 관리자
• 초보자를 위한 "good first issue" 라벨

완료된 작업, 진행 중인 작업, 다음 계획에 대한 자세한 내용은 **미래 목표 및 개발자 브리핑**을 참조하세요.

이 문서에는 다음이 포함됩니다:

• ✅ 완료된 오픈 소스 준비 작업
• 🚧 현재 우선 순위 (코드 정리, Docker 설정, 문서화)
• 🔮 향후 개선 사항 및 기능

💡 아이디어가 있나요? GitHub 토론을 열거나 기존 스레드에 기여하세요

🗳️ 기능에 투표 -- 관심 있는 이슈에 별표를 표시하여 우선순위 지정을 도와주세요

🛠️ 목록에 없는 것을 구축하고 싶나요? -- 제안하세요! 우리는 커뮤니티 주도 기능을 환영합니다

5분 이내에 기여 시작:

# GitHub에서 리포지토리를 포크한 다음 포크를 클론
git clone https://github.com/YOUR_USERNAME/studyield.git
cd studyield

# Docker로 시작 (가장 쉬운 방법)
cp backend/.env.example backend/.env
docker compose --env-file .env.docker up -d

# 앱에 액세스
# 프론트엔드: http://localhost:5189
# 백엔드 API: http://localhost:3010

이게 전부입니다! 이제 Studyield가 로컬에서 실행되고 있습니다.

경험 수준에 따라 선택:

🟢 초보자 친화적

• 📝 오타 수정 또는 문서 개선
• 🌍 번역 추가 -- 12개 언어 지원
• 🐛 간단한 버그 수정
• ✨ UI/UX 개선

🟡 중급

• 🔌 새로운 AI 에이전트 도구 또는 기능 추가
• 📊 분석 대시보드 및 시각화 개선
• 🧪 테스트 작성
• 🚀 성능 개선

🔴 고급

• 🤖 새로운 AI 기능 구축 (멀티모달 입력, 고급 추론)
• ⚙️ 핵심 엔진 개선
• 🏗️ 아키텍처 개선
• 🔐 보안 기능

# 새 브랜치 생성
git checkout -b feature/your-feature-name

# 변경 사항 적용
# - 백엔드 코드: /backend/src/modules
# - 프론트엔드 코드: /frontend/src
# - 모바일 코드: /mobile/lib

# 변경 사항 테스트
# 백엔드: cd backend && npm run test
# 프론트엔드: cd frontend && npm run build

# 명확한 메시지로 커밋
git commit -m "feat: add voice input support for teach-back"

# 포크에 푸시
git push origin feature/your-feature-name

# GitHub에서 PR 열기
# - 무엇을 변경했고 왜 변경했는지 설명
# - 관련 이슈에 링크
# - UI 변경인 경우 스크린샷 추가

다음에 무슨 일이 일어나나요?

• ✅ PR에서 자동 테스트가 실행됩니다
• 👀 유지 관리자가 코드를 검토합니다 (보통 24-48시간 이내)
• 💬 변경 사항이나 개선 사항을 제안할 수 있습니다
• 🎉 승인되면 코드가 병합됩니다!

✨ 작게 시작 -- 첫 번째 PR이 거대한 기능일 필요는 없습니다

📖 코드 읽기 -- 참고를 위해 기존 모듈 및 구성 요소 찾아보기

❓ 질문하기 -- 막히면 토론에 참여하세요

• 💬 Discord Community -- Join our Discord server

🧪 테스트 작성 -- 테스트가 포함된 PR이 더 빨리 병합됩니다

📝 코드 문서화 -- 복잡한 로직에 주석 추가

• 💬 GitHub 토론 -- 질문하기, 아이디어 공유
• 💬 Discord Community -- Join our Discord server
• 📖 기여 가이드 -- 자세한 기여 가이드라인
• 🐛 GitHub Issues -- 버그 보고 또는 기능 요청
• 📧 이메일 -- 유지 관리자에게 직접 연락

기여를 환영합니다! 시작하려면 기여 가이드를 참조하세요.

기여 방법:

• GitHub Issues를 통해 버그 보고 또는 기능 요청
• 버그 수정 또는 새 기능에 대한 풀 리퀘스트 제출
• 문서 개선
• 번역 추가 (12개 언어 지원)

Studyield에 기여해 주신 모든 멋진 분들께 감사드립니다! 🎉

여기에서 귀하의 얼굴을 보고 싶으신가요? 기여 가이드를 확인하고 오늘부터 기여를 시작하세요!

개발자와 연결하고, 도움을 받고, Studyield의 최신 개발에 대한 최신 정보를 받으세요!

• 🤝 존중하기 -- 모든 사람을 존중과 친절로 대하기
• 💡 지식 공유 -- 다른 사람들이 배우고 성장하도록 돕기
• 🐛 문제 보고 -- 버그를 발견했나요? GitHub Issues에서 알려주세요
• 🎉 승리 축하 -- 학습 성취와 성공 사례 공유
• 🌍 글로벌하게 생각 -- 우리는 12개 이상의 언어를 사용하는 전 세계 커뮤니티입니다

보안 취약점은 책임감 있게 보고해 주세요. 공개 정책은 SECURITY.md를 참조하세요.

이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여됩니다.

Copyright 2025 Studyield Contributors.

NestJS, React, Flutter, PostgreSQL, Redis, Qdrant, ClickHouse, OpenRouter 및 기타 많은 훌륭한 오픈 소스 기술로 구축되었습니다.

웹사이트 | 문서 | 토론 | Twitter

Studyield 커뮤니티가 ❤️로 구축

이 프로젝트가 유용하다고 생각되시면 별표를 주는 것을 고려해 주세요! ⭐