설치 전 궁금한 점

직접 고른 자료로 언어를 배우고, 몇 달이나 몇 년에 걸쳐 꾸준히 복습하고 싶은 분에게 맞습니다. 책, 자막, 수업, 대화에서 단어를 고르면 kamishibai가 카드로 만듭니다. 강좌를 대신하는 프로그램은 아니므로, 배울 주제와 순서는 직접 정합니다.

복습은 Anki가 맡습니다. 간격 반복을 바탕으로 잘 기억하는 카드는 더 긴 간격으로, 잊어버린 카드는 더 빨리 보여 줍니다. 새 카드 수와 하루 학습 한도는 Anki에서 설정할 수 있습니다.

저는 새로운 세대의 AI 에이전트 덕분에, 예전에 블로그를 쓰듯 쉽게 자기 색깔이 담긴 소프트웨어를 만들 수 있다고 생각합니다. 자신의 경험을 다른 사람도 쉽게 활용할 수 있는 방법으로 정리해 나누는 것입니다. Kamishibai는 이 생각을 직접 해 보는 프로젝트입니다. 무엇보다 제가 매일 직접 사용하는 도구이며, 실제로 쓰면서 쌓은 경험을 바탕으로 발전시키고 있습니다.

만화가는 이야기, 그림, 인물의 개성을 직접 하나의 작품으로 엮습니다. 저는 이런 창작 방식에 공감합니다. Kamishibai의 시각적 스타일을 만화에서 가져온 이유도 여기에 있습니다. 기획에서부터 화면의 모습까지, 만든 사람의 관점이 드러나는 프로젝트를 좋아합니다.

기본 모드에서는 배우고 싶은 단어나 표현의 목록을 넣습니다. 사전에 나오는 기본형으로 바꿀 필요는 없습니다. Kamishibai가 입력한 내용을 파악해 뜻을 제안하면 필요한 것을 고르면 됩니다. 선택한 뜻마다 예문이 담긴 별도의 카드를 만듭니다.

예문이 마음에 들지 않으면 바꾸고 싶은 점을 설명하고 다시 만들 수 있습니다. 카드에 쓸 글을 이미 준비했다면 cards JSON 형식으로 전달할 수도 있습니다. 자세한 내용은 아래 항목에서 설명합니다.

Kamishibai는 학습 자료를 만듭니다. 예문, 설명, 음성, 삽화를 생성한 뒤 Anki에서 열 수 있는 덱인 .apkg 파일로 묶습니다.

Anki는 복습을 관리합니다. 카드를 보여 주고, 직접 매긴 평가를 기록하고, 다음 복습 날짜를 정합니다.

Kamishibai는 종이 카드용 PDF도 만듭니다. 화면 없이 공부하고 싶다면 출력해서 잘라 쓰면 됩니다.

아니요. 설치한 뒤 글자로 조작하는 창인 터미널에서 kamishibai를 실행합니다. 이후에는 단어 추가, 뜻 선택, 카드 확인, 덱 만들기까지 프로그램이 차례로 안내합니다. 코드를 쓸 필요는 없습니다.

자동화를 위해 결과를 JSON으로 돌려주는 별도 명령도 있습니다. 스크립트나 AI 에이전트가 사용할 수 있지만, 일반적인 사용에는 필요하지 않습니다.

단어와 뜻은 직접 고르고, AI 모델이 kamishibai에 정해진 규칙에 따라 자료를 만듭니다. 이 규칙에는 카드의 구조와 예문, 설명, 음성, 삽화에 대한 요구사항이 담겨 있습니다.

생성 전에는 난이도와 문장 유형을 선택할 수 있습니다. 평서문, 의문문, 대화 또는 이들을 섞은 형식입니다. 완성된 결과를 확인하고 원하는 수정 사항을 덧붙여 다시 만들 수도 있습니다.

22개 언어를 지원합니다. 영어, 중국어, 스페인어, 일본어, 프랑스어, 독일어, 한국어, 러시아어, 이탈리아어, 포르투갈어, 힌디어, 아랍어, 튀르키예어, 폴란드어, 우크라이나어, 인도네시아어, 베트남어, 태국어, 그리스어, 히브리어, 네덜란드어, 체코어입니다.

덱마다 배울 언어 하나와 번역·설명에 쓸 언어 하나를 고릅니다. 목록에 있는 어떤 두 언어든 조합할 수 있습니다. 자료의 품질은 모델이 선택한 언어 조합을 얼마나 잘 다루는지에 따라 달라집니다.

다른 언어가 필요하면 GitHub에 요청을 남겨 주세요. 가능한 방법을 살펴보겠습니다.

카드를 만들려면 다음이 필요합니다.

• macOS, Linux 또는 Windows 컴퓨터.
• 인터넷 연결. 글, 음성, 삽화는 Gemini API를 통해 생성합니다.
• 본인의 Gemini API 키. Google AI Studio에서 키 만들기 →

복습하려면 Anki를 설치하세요 →

선택한 언어에서 이미지 속 글자를 로컬로 검사해야 하는 경우, 처음 삽화를 만들 때 문자 인식(OCR) 모델도 내려받습니다.

macOS, Linux, Windows에서 바로 쓸 수 있는 프로그램을 제공합니다.

• macOS와 Linux: Homebrew 또는 설치 스크립트를 사용합니다.
• Windows: Git Bash, MSYS 또는 Cygwin에서 설치 스크립트를 실행합니다.

명령과 스크립트 링크는 설치 안내에서 확인할 수 있습니다.

Kamishibai는 무료이며 소스 코드도 공개되어 있습니다. 본인의 API 키로 Gemini를 호출하는 비용은 별도로 냅니다.

글, 음성, 삽화가 포함된 카드 100장에 약 15달러를 예상하면 됩니다. 대략적인 금액으로, 자료의 양과 다시 만드는 횟수, 모델 요금에 따라 달라집니다. 프로그램에 모델이 이미 정해져 있어 시작할 때 따로 설정할 필요는 없습니다.

하루에 새 카드 네 장씩 배우면 100장은 25일 분량입니다. 배운 문장도 이후 계속 복습해야 합니다. 그래서 저는 실제로 쓰고 싶은 단어를 고르고, 생성 비용을 최소로 줄이는 것보다 카드의 품질을 우선합니다.

설정, 세션, 캐시, 완성된 파일은 본인의 컴퓨터에 저장됩니다. Kamishibai에는 카드를 만드는 자체 서버가 없습니다.

자료를 생성하고 검사할 때는 본인의 API 키로 단어, 문장, 검사할 삽화를 Gemini에 보냅니다. Anki로 동기화하면 완성된 덱과 미디어도 AnkiWeb에 전송됩니다.

저장한 키는 로컬 설정 파일에 있으며, 운영 체제의 비밀번호 보관소에는 저장되지 않습니다. 이 파일을 다른 사람에게 보내거나 공개 저장소에 올리지 마세요.

네, 오류가 생길 수 있습니다. 다만 제가 써 본 경험으로는 현재 세대의 모델은 꽤 안정적인 결과를 내고 있고, 저도 완성된 카드의 품질을 높이는 데 많은 노력을 기울이고 있습니다.

현재 가장 안정적인 부분은 음성으로, 자연스러운 말소리에 가깝습니다. 문장 난이도를 맞추는 데는 정확도가 조금 떨어집니다. 선택한 수준에 맞추려 하지만, 때로는 더 쉽거나 어려운 문장이 나옵니다.

오류가 가장 많은 것은 삽화입니다. AI는 여전히 사람에게 세 번째 팔을 그려 넣기도 합니다. 그래서 앱에는 완성된 그림을 평가하는 별도의 AI 모델이 있습니다. 검사를 통과하지 못한 이미지는 다시 만듭니다.

자동 검사로 모든 자료의 정확성을 보장할 수는 없습니다. 의심스러운 문장은 사전을 찾아보거나 선생님에게 확인하고, 필요하면 카드를 다시 만드는 것이 좋습니다.

Claude Code 같은 AI 에이전트가 kamishibai를 사용할 수 있다는 뜻입니다. 작업을 설명하면 에이전트가 프로그램 명령을 통해 수행합니다. 예를 들어 다음과 같은 일을 맡길 수 있습니다.

• 주제에 맞는 단어를 고르거나 내 글에서 단어를 추리기.
• 필요한 뜻을 선택하고 카드 만들기.
• 결과를 확인하고, Anki로 가져오기 전에 잘못된 카드 다시 만들기.

이를 위해 JSON CLI를 제공합니다. 터미널에서 질문에 답하는 과정 없이 JSON 형식의 데이터를 반환하는 명령입니다. 에이전트는 백그라운드에서 생성을 진행하고 여러 세션을 동시에 다룰 수 있습니다.

에이전트에게 llms.txt 링크를 전달하세요. Kamishibai를 설치하거나 업데이트하는 방법과 설치된 버전의 내장 안내를 가져오는 방법이 나와 있습니다. 에이전트 자체의 이용과 추가 카드 생성으로 비용이 늘어날 수 있습니다.

수업에서 배운 문장이나 짧은 대화처럼 이미 정해진 표현을 그대로 쓰고 싶을 때 유용합니다. 단어 목록 대신 카드 내용을 cards JSON 파일로 전달합니다. 정해진 구조에 맞춰 쓰는 텍스트 파일입니다.

파일에는 문장뿐 아니라 카드의 필수 항목이 모두 있어야 합니다. 직접 준비하거나 AI 에이전트에게 맡길 수 있습니다. 파일에 쓴 표현은 고쳐 쓰지 않고 그대로 유지합니다. Kamishibai가 음성과 삽화를 더한 뒤 APKG 형식의 Anki 덱과 인쇄용 PDF를 만듭니다.

구조, 필수 항목, 예시는 cards-json.md에서 확인하세요 →

네. Kamishibai로 컴퓨터에서 카드를 만들고, Anki 모바일 앱에서 복습할 수 있습니다.

• 완성된 .apkg 파일을 컴퓨터의 Anki에서 엽니다. 더블 클릭으로 가져오기가 시작되지 않으면 파일 → 가져오기를 선택하세요.
• AnkiWeb을 통해 컬렉션을 동기화합니다.
• 모바일 앱에서 같은 계정으로 로그인하고 동기화를 실행하면 카드, 그림, 음성을 내려받을 수 있습니다.

화면 없이 공부하려면 PDF를 출력해 자르고 접어 종이 카드로 만들 수 있습니다. 종이 카드에는 음성과 자동 복습 일정이 없습니다.

글, 음성, 삽화는 Gemini 계열 모델이 생성합니다. Kamishibai는 모델에 지시를 전달하고, 결과의 일부를 검사하고, 자료를 카드로 묶습니다.

음성은 모델이 합성한 것으로, 성우가 녹음한 것이 아닙니다. 학습을 시작하기 전에 다른 내용과 함께 확인해야 합니다.

문장의 뜻이나 핵심 단어가 생각나지 않으면 ‘다시’를 누르세요. Anki가 그 카드를 더 일찍 복습하도록 잡아 줍니다. 새 카드든 몇 달 동안 알고 있던 카드든 같습니다.

평가를 얼마나 엄격하게 할지는 지금 무엇을 연습하는지에 따라 다릅니다. 저는 처음에는 뜻과 핵심 단어가 떠오르면 관사나 전치사의 작은 실수는 허용합니다. 문장이 익숙해지면 이런 세부 사항도 정확하게 답하려고 합니다.

한 카드가 계속 어렵다면 문장 자체를 살펴보세요. 상황이 분명한지, 모르는 내용이 너무 많지 않은지 확인하는 것입니다. 같은 형태로 계속 외우려 하기보다 예문을 쉽게 바꾸거나 교체하는 편이 나을 때도 있습니다.

정해진 기간은 없습니다. 시작할 때의 수준, 고른 문장, 복습의 꾸준함, Anki 밖에서도 해당 언어를 쓰는지에 따라 달라집니다.

첫 50문장을 충분히 익혔다면 점검의 계기로 삼아 보세요. 익숙한 표현이 더 쉽게 떠오르는지, 새로운 글에서 알아보는지, 대화에서 쓸 수 있는지 확인하는 것입니다. 50문장을 넘으면 반드시 ‘언어 감각’이 생긴다는 뜻은 아닙니다. 카드 수뿐 아니라 실제로 할 수 있게 된 일을 살펴보세요.