코드로 그리는 잉크 선 인물, 어떤 크기에서도 선명하게, 확산 모델 없이

지금 AI로 움직이는 일러스트를 만드는 사람 앞에는 갈림길이 있고, 거의 모두가 같은 쪽으로 갑니다. 장면을 설명하면 확산 모델이 프레임을 샘플링하고, 영상이 나옵니다. 비싸 보입니다. 고칠 수도 없고, 재현되지 않고, 모델이 학습한 해상도에 묶입니다.
line-art-animation은 반대쪽으로 갑니다. Claude skill 하나와 작은 TypeScript 라이브러리로, 종이에 잉크로 그린 인물을 SVG 안에서 실시간으로 그립니다. 인물은 걷고, 자전거를 타고, 모자를 들어 인사합니다. 장면은 늦은 오후부터 밤까지 이어집니다. 샘플링은 없습니다. 모든 프레임을 계산합니다. 출력은 벡터라서 어떤 크기에서도 선명하고 포인터에 반응할 수 있습니다.
이 저장소를 읽을 만한 이유는 좋은 연필화를 볼 만한 이유와 같습니다. 일을 하는 쪽은 제약입니다.
저장소 안에 실제로 있는 것
의존성 없는 TypeScript 모듈 네 개, 각각 하는 일은 하나입니다.
ink.ts는 그리기 기본 요소를 담습니다. gait.ts는 걷기와 달리기 솔버이고, 한 걸음의 특정 위상에서 무릎이 어디로 가는지 정하는 부분입니다. motion.ts는 스프링, 진자, 바람을 맡습니다. daynight.ts는 시간대 팔레트입니다.
예제 두 개가 함께 옵니다. examples/walker는 약 150줄짜리 인물 하나입니다. 서류 가방을 든 남자가 카드를 가로질러 걷고, 클릭하면 모자를 들어 인사합니다. 저장소에서 가장 작은 완성품이고, 코드를 읽기 시작하기에 맞는 자리입니다.
examples/village는 장면 전체입니다. 마치야가 늘어선 거리, 운하 옆 찻집과 목욕탕, 시간표대로 움직이는 마을 사람들, 고양이, 새, 뱃사공, 불 켜진 창과 반영, 그리고 십여 개의 상호작용. 해나 달을 하늘에서 끌면 장면 전체의 시간이 따라 바뀝니다. 포인터를 움직이면 바람이 일어납니다. 사람, 창, 등불, 윈드차임, 고양이, 새, 물을 클릭할 수 있습니다.

scripts/ 디렉터리도 있습니다. 영상 출력을 위한 결정론적 프레임 캡처와 참조 클립을 재는 도구가 들어 있습니다. 뒤쪽이 조용한 일꾼입니다. 이미 있는 클립을 skill에 넘기고 걷기를 맞추라고 할 수 있습니다.
skill로 설치하기
Claude Code라면 skills 폴더에 클론합니다.
git clone https://github.com/JDhruv14/line-art-animation ~/.claude/skills/line-art-animation
프로젝트 하나로 범위를 좁히고 싶다면 그 프로젝트의 .claude/skills/에 넣습니다. 그다음 원하는 것을 그대로 말하면 됩니다.
- "새벽의 빵집 선화 애니메이션을 만들어 줘. 쟁반을 나르는 제빵사, 오븐에서 피어오르는 김, 창가에 앉은 고양이." - "이 클립을 반복되는 선화 컴포넌트로 바꿔 줘. 걷기는 정확히 맞춰서." 클립을 첨부하거나 링크를 줍니다. - "장면에 낮과 밤 사이클을 넣고 30초 1080p 영상으로 렌더링해 줘."
그다음에 벌어지는 일이, 제가 skill을 쓴다면 그대로 베낄 부분입니다. Claude는 SKILL.md를 읽고, lib/를 프로젝트로 복사하고, 인물 하나만 먼저 보여 주고 승인을 받은 뒤 나머지를 짓고, 넘기기 전에 움직임을 프레임 단위로 확인합니다. 인물 하나, 승인, 그다음 확장. 이 순서는 실패 비용에 대한 설계입니다. 스타일이 틀린 걸 인물 하나에서 잡으면 1분이고, 완성된 거리에서 잡으면 반나절입니다.
예제를 돌리려면 Node 22.18 이상이 필요합니다.
npm install
npm run dev # http://localhost:5173
장면에는 URL 플래그가 있습니다. 개발 중에 필요해서 만들었고 그대로 남긴 것입니다. ?start=0.9는 시작 시간을 정합니다. 0이 자정, 0.5가 정오입니다. ?tau=0.5는 그 시간에 고정합니다. ?day=30은 하루를 30초에 돌립니다. ?debug는 시간을 손으로 넘깁니다. npm run typecheck는 lib/와 walker에 대해 strict입니다.
왜 반대쪽인가
성질을 나란히 놓아 봅니다. 거의 완전히 뒤집혀 있으니까요.
생성한 영상 클립은 초당 비용이 비싸고, 나중에 고칠 수 없고, 실행할 때마다 다르고, 해상도가 고정됩니다. 등불을 조금 더 밝게 하고 싶으면 다시 생성하는 수밖에 없습니다. 마우스에 반응하게 만들 수는 없습니다.
선화 SVG 컴포넌트는 몇 KB이고, 코드에서 고칠 수 있고, 몇 번을 돌려도 같고, 해상도와 무관합니다. 등불 불투명도는 한 군데만 바꾸면 됩니다. 포인터에 반응하는 건 살아 있는 장면이라서 그렇습니다.
대가는 범위입니다. 이 라이브러리는 시각 언어 하나만 그립니다. 종이 위의 잉크, 얇은 윤곽의 인물, 단순한 도형으로 세운 장면. 모공이 보이는 얼굴은 못 그립니다. 사진 같은 의미에서 물처럼 보이는 물도 못 그립니다. 물로 읽히는 선의 묶음을 그립니다. 사진급 제품 사진이 필요하다면 이 저장소는 맞지 않고, 맞는 척도 하지 않습니다.
그래도 그 하나의 언어 안에서는 확산 모델이 아직 어려워하는 일을 해냅니다. 장면을 넘어 인물이 일관됩니다. 마을 사람은 샘플이 아니라 함수이기 때문입니다. 움직임은 재현됩니다. 걸음은 발명되는 게 아니라 풀리기 때문입니다. 결과물은 git에서 diff를 뜰 수 있습니다.
흥미로운 건 걸음 솔버
시각적 설득력의 대부분은 gait.ts에 있고, README가 그것을 맨 앞에 둔 건 맞습니다.
걷기는 위상 문제입니다. 어느 순간이든 각 다리는 지지나 흔들기 중 하나에 있고, 골반은 위아래와 좌우로 흔들리고, 팔은 반대로 흔들립니다. 이들 사이의 타이밍이 걷기를 걷기로 읽히게 하는지, 끌려가는 인형으로 읽히게 하는지를 정합니다. 위상 관계가 틀리면 명암을 아무리 넣어도 못 살립니다. 맞으면 막대 인간도 무게가 있어 보입니다.
장면 수준도 같습니다. motion.ts가 스프링, 진자, 바람을 다루기 때문에 포인터가 윈드차임을 지나가면 소리가 나고, 배는 맞는 주기로 흔들립니다. 어느 것도 생성된 게 아닙니다. 전부 적은 수의 매개변수에서 계산됩니다. 그래서 시간이 뛰어도 장면이 이어집니다.
거래를 한 문장으로 말하면 이렇습니다. 확산 모델은 범위를 주고 통제를 가져갑니다. 이쪽은 통제를 주고 범위를 가져갑니다.
실제로 쓸모 있는 곳
세 군데입니다. 예제를 보면서 든 생각입니다.
움직여야 하는 편집 일러스트. 블로그 글이나 랜딩 페이지에 놓는 15초 루프, 스타일이 일관되고 내보내는 파일이 작습니다. 생성한 영상이라면 2 MB에 매번 조금씩 어긋납니다.
그림이 내레이션과 정확히 맞아야 하는 설명물. 움직임이 결정론적이라 특정 사건을 특정 비트에 맞출 수 있습니다. 빵집 예제가 그걸 합니다. 김, 쟁반, 고양이가 각자 시간표대로 움직입니다.
UI 안에 살아 있어야 하는 모든 것. hover와 화면 크기에 반응하는 SVG 컴포넌트는 MP4와 다른 물건이고, 디자인 시스템에는 후자를 놓을 자리가 없습니다.
30초 1080p 렌더는 정말 파일이 필요한 경우를 위해 있습니다. 결정론적 캡처는 실행할 때마다 같은 프레임을 냅니다. 생성한 클립을 다시 내보내 컷을 맞춰 본 적이 있다면 그게 얼마나 드문 일인지 알 겁니다.
짧게 정리하면
좁은 도구이고, 좁은 범위 안에서는 아주 잘합니다. README도 과장하지 않습니다. 선화라고 말하고, 선화를 보여 주고, 예제도 선화입니다. 밤의 마을, 불 켜진 창, 운하의 반영까지 포함해서요. 그런 세부는 누군가 결과를 신경 썼을 때만 나옵니다.
AI 애니메이션 영역을 보는 사람에게 눈에 띄는 건 이게 존재한다는 사실 자체입니다. 2026년의 기본 가정은 애니메이션이 생성 문제라는 것입니다. 이 저장소는 그것을 그리기 문제로 다루고, 걸음 솔버와 모듈 네 개, 팔레트 하나로 풉니다. 해 질 녘의 거리, 불 켜진 창, 운하의 반영이라면, 사람이 페이지에 머무를 만한 것을 만드는 데 그걸로 충분합니다.
클론하기 전에 제약 두 가지입니다. 그리는 스타일은 하나이고, 두 번째로 넓히려면 새 모듈이 필요합니다. 그리고 승인 루프에는 이유가 있습니다. 처음부터 마을 전체를 달라고 하면 원하지 않던 스타일을 고치는 데 반나절을 씁니다.