Tencent/WeSmartFlow

Every question can open a new path. WeSmartFlow turns learning into conversation, exploration, stories, and hands-on discovery.

WeSmartFlow – 오픈소스 적응형 학습 플랫폼

개요 – WeSmartFlow는 AI 에이전트가 개인 학습 동반자 역할을 하도록 하는 오픈소스 프레임워크입니다. 학습자의 목표를 이해하고, 학습 경로를 생성하고, 대화형 콘텐츠(카드, 시각화, 퀴즈, 오디오)를 만들고, 개인 지식 그래프에서 진행 상황을 추적하고, 게임과 같은 "탐험" 세계에 경험을 포함시킬 수 있습니다. 저장소에는 재사용 가능한 에이전트 코어, FastAPI 백엔드 서비스, Vue-3 프런트엔드 및 예제 "탐험" 주제가 포함되어 있습니다.

핵심 기능

기능	설명
ReAct 스타일 튜터링 에이전트	도구(검색, 지식 그래프, HTML 카드 생성기, EduViz 시각화 도구, 퀴즈 메이커, TTS)를 사용하여 질문에 답하고, 학습 산출물을 만들고, 학습자의 지식 그래프를 업데이트합니다.
그래프 메모리(개인 지식 뇌)	개념을 관계(전제 조건, 관련 등)와 함께 노드로 저장하고, SM-2 간격 반복으로 숙달 수준을 추적하며, 이 그래프를 무료 튜터링 및 몰입형 코스에서 공유합니다.
멀티 에이전트 코스 생성	전문 에이전트(플래너, 연구원, 작가, 일러스트레이터, 음성, 퀴즈)의 파이프라인이 전체 코스(PDF + 오디오 + 연습 + 지식 그래프 항목)를 자동으로 구축합니다.
HTML 지식 카드 및 EduViz	카드: 개념의 정적, 인쇄 가능 요약. EduViz: SDK에서 생성되고 브라우저에서 렌더링되는 JavaScript 기반 대화형 시각화.
탐험 모드	모든 프런트엔드 기술(Vue, React, Three.js 등)로 구축된 플러그인 학습 세계(예: "Magic English Town", "Math Garden"). 메인 사이트는 카탈로그 JSON을 통해 이를 로드합니다.
WeClaw WeChat 브리지	WeChat 메시지를 동일한 튜터링 서비스로 전달하는 선택적 채널로, Playwright로 카드를 이미지로 렌더링한 후 전송합니다.

아키텍처 스냅샷

WeSmartFlow/
├─ backend/                # FastAPI 서버, agent_core, 서비스, DB(SQLite + 벡터 스토어)
│   ├─ agent_core/        # ReAct, DAG 워크플로우, 도구 등록
│   ├─ agents/            # 튜터링, 연구 등에 대한 프롬프트 템플릿
│   ├─ services/          # 튜터링, 코스 생성, 지식 그래프 API
│   └─ channels/          # WeClaw(WeChat) 통합
├─ frontend/               # Vue-3 SPA – 채팅, 코스 뷰어, 그래프, 퀴즈, 탐험 페이지
├─ examples/               # 독립적인 "탐험" 주제 + 카탈로그 JSON
└─ environment.yml         # Conda 환경(Python 3.10+, Node 25)

백엔드는 LLM_API_KEY, LLM_BASE_URL, LLM_MODEL을 통해 모든 OpenAI 호환 LLM과 통신합니다. 프런트엔드는 REST API를 사용하고, 에이전트 응답을 스트리밍하며, 생성된 카드/시각화를 표시합니다.

시작하기(README에 설명된 대로)

복제(미디어 자산을 위해 Git LFS 사용).
Conda 환경 생성(conda env create -f environment.yml).
프런트엔드 종속성 설치(npm --prefix frontend install).
.env에서 LLM 구성(OpenAI, DeepSeek 등) 및 선택적 인증 제공자(GitHub OAuth, 이메일 SMTP, WeChat).

실행:

# 터미널 1
cd backend && python main.py   # FastAPI on :8080
# 터미널 2
cd frontend && npm run dev    # Vue dev server on :5173

http://localhost:5173을 엽니다 – 무료 튜터링, 몰입형 코스 또는 탐험 페이지를 시도할 수 있습니다.

선택적 추가 기능:

WeClaw – WECLAW_ENABLED=true를 활성화하고 WeChat 봇을 바인딩합니다.
PDF 코스 생성 – XeLaTeX/latexmk 및 SimplePlus Beamer 테마를 설치합니다.

누가 사용할까요?

교육자 – 전체 스택을 구축하지 않고 대화형 AI 생성 코스를 제작하려는 사람.
개발자 – 교육에 맞춰진 재사용 가능한 에이전트 프레임워크(agent_core)를 찾는 사람.
학습자 – 이전 세션을 기억하고 커리큘럼을 적응시키는 개인 AI 튜터를 원하는 사람.

라이선스

MIT – 상업적 및 비상업적 용도로 무료입니다.

위의 모든 세부 사항은 저장소의 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.