with-pebbly/aseprite-ai-artist

생성된 PNG가 아닙니다. 뒤에서 몰래 변경된 파일도 아닙니다. 화면의 문서, 한 픽셀씩 — 그리고 모든 단계는 Ctrl+Z입니다.

☔ 500×400 · 24fps 384 프레임 · 16초 · 24 레이어 — 이 서버를 통해 Claude Opus 5.5가 그린 것입니다.

설치하기 · 그리는 방법 · 기술 · 갤러리

"PICO-8 팔레트로 된 32×32 기사 캐릭터를 그려주고, 여기에 4프레임의 유휴(idle) 동작을 추가해줘."

이렇게 입력하면 Aseprite에서 벌어지는 것을 지켜보세요: 팔레트, 실루엣, 음영 처리,
레이어, 숨 쉬는 듯한 유휴 애니메이션, 태그가 지정된 사이클. 에이전트는 매 단계마다 자신이 만든 결과물을 확인하고, 마지막에 어떤 부분에서 타협했는지 알려줍니다.

당신이 통제권을 갖습니다. 투구가 마음에 안 드나요? Ctrl+Z를 누르거나, 그냥 그렇게 말하세요.

Claude Code, omp, Codex CLI, Gemini CLI, Cursor, VS Code 및 Windsurf와 함께 작동합니다. 지금까지 최고의 결과: Claude Opus 5.5.

Aseprite 1.3 이상과 Node 22.6 이상(macOS, Linux 또는 Windows)이 필요합니다.

1. Aseprite 확장 기능 — 그리고 Aseprite를 종료했다가 다시 실행하세요:

npx @pebbly/aseprite-ai-artist install-extension

2. 당신의 에이전트:

Claude Code

/plugin marketplace add with-pebbly/aseprite-ai-artist
/plugin install aseprite@aseprite-ai-artist

omp

omp plugin marketplace add with-pebbly/aseprite-ai-artist
omp plugin install aseprite@aseprite-ai-artist

Codex, Gemini, Cursor, VS Code, Windsurf

npx @pebbly/aseprite-ai-artist install codex # 또는 gemini, cursor, --all

설정은 먼저 백업되며; --dry-run은 변경 사항을 보여줍니다.

3. 확인하기 — 에이전트를 다시 시작한 다음:

npx @pebbly/aseprite-ai-artist doctor

모든 체크 표시(tick)는 준비가 되었음을 의미합니다. 업데이트하려면 1단계를 다시 실행하세요. 특이한 설정(Steam, 사용자 지정 폴더, Windows 경로)은 docs/INSTALL.md에 있습니다.

창 없이? 헤드리스 모드 (Headless mode)

CI 또는 일괄 자산 처리를 위해, 서버는 창 없이 Aseprite 자체를 실행할 수 있습니다:

npx @pebbly/aseprite-ai-artist serve --headless --aseprite /path/to/aseprite

에이전트가 저장할 때만 디스크에 내용이 기록되며, 열려 있는 에디터의 파일에는 절대 접근하지 않습니다. 백업 방식은 아닙니다. 창이 연결되어 있지 않으면 조용히 전환하는 대신 에이전트에게 요청합니다.

/aseprite:studio를 통해 무엇이든 물어보면 전체 작업을 수행합니다:

픽셀이 변경된 모든 단계 후에는 다음 단계로 넘어가기 전에 결과물을 확인합니다.

0.5.0 버전에서 새로 추가되었습니다. 에이전트는 원과 사각형으로 그리지 않고 — 프레임 전체를 텍스트로 타이핑하여 픽셀당 하나의 문자로 구성하고, 이 텍스트를 한 번의 호출로 그림을 그립니다. 무언가를 수정하려면 동일한 형식으로 캔버스를 읽어 들인 후 잘못된 문자만 변경합니다.

전체 모양을 쓰면서 보기 때문에 실루엣은 균일하게 유지되고, 사지들은 프레임 간에 길이를 유지하며, 편집이 이웃 영역으로 새어 나가는 일이 없습니다. 애니메이션도 같은 원리입니다: 이전 프레임의 행들을 복사하고, 팔을 움직이고, 그립니다.

0.6.0 버전부터 모든 문자는 하나의 팔레트 항목을 나타내며, 읽을 때마다 동일합니다. 따라서 큰 캔버스를 글자들이 의미를 바꾸지 않도록 조각별로 읽고 편집할 수 있습니다. 그리드는 캔버스만큼 클 수 있습니다.

초기 신호일 뿐 측정치는 아닙니다: 같은 모델과 프롬프트를 사용했음에도 불구하고, mage 벤치마크는 3 → 4/10으로, road는 1 → 3/10으로 상승했습니다. 트리는 2에 머물렀습니다 (비교해 보세요).

이 에이전트는 손을 16px에서 임의로 만들거나 말의 걸음걸이를 만들어내지 않습니다. 대신 찾아봅니다.

62개 규칙 · 약 400개의 픽셀 템플릿 · 2006개의 팔레트 — 다음에서 둘러보세요:
pixeli.pebbly.space/knowledge 👀

모든 규칙은 크기 예산, 절차, 흔한 실수 및 에이전트가 캔버스에 바로 붙여넣는 그리드 템플릿을 제공합니다. 모든 MCP 클라이언트는 이를 rules:// 리소스에서 읽습니다.

🎨 팔레트 (Palettes): 콘솔 클래식 팔레트에 Lospec의 다운로드 순위 2000위까지 추가되었으며, 각각 출처가 명시되어 있습니다 — `preset:

이런 기능들을 사용해 보세요. 원하는 단계를 알 때 직접 호출할 수 있습니다.
— /aseprite:<이름> 형식으로

Claude Code와 omp에서, 또는 다른 곳에서 그냥 요청하세요.

Claude Code와 omp에서는 네 명의 전문가가 메인 에이전트로부터 단계별로 작동합니다:
palette-smith, rig-builder, animation-director 그리고 읽기 전용의 pixel-critic입니다.

벤치마크를 통해 실시간으로 확인하세요: 모든 모델은 동일한 고정 프롬프트를 그리며, 작성된 기준에 따라 점수가 매겨집니다. 귀하의 모델이 여기에 없나요? 스프라이트를 보내주세요!

플러그인으로 그려진 모든 것 — 그 프롬프트, 모델 및 .aseprite 소스는 pixeli.pebbly.space에 있습니다. 이 벤치마크는 모든 모델과 플러그인 버전을 동일한 세 가지 고정 프롬프트를 거쳐 작성된 기준에 따라 점수를 매기며, 지식 기반은 에이전트들이 따르는 규칙서를 보여줍니다.

무언가를 만드셨나요? 에이전트에게 /aseprite:submit을 요청하세요.

— 파일들을 패키징하고 풀 리퀘스트를 열어줍니다.

your agent ──MCP──▶ server ──▶ bridge ──▶ Aseprite extension

명사별로 그룹화된 18가지 도구(draw, look, layer, frame, export 등)가 아흔 가지에 대비됩니다. — 모든 도구가 턴마다 컨텍스트 비용을 발생시킵니다. 참조하세요.**지식 기반(knowledge base)**은 rules/에 있으며, 라인 아트부터 워크 사이클까지 62개 파일과 픽셀 템플릿이 포함되어 있고, MCP를 통해 제공되므로 모든 클라이언트가 동일한 아트 지식을 얻습니다.기본적으로 안전합니다. 모든 동작은 되돌리기(undo) 단계입니다. Aseprite가 분리된 상태에서는 도구들이 디스크의 파일을 편집하는 대신 거부합니다. 모든 것은 127.0.0.1에 바인딩됩니다. 자세한 내용은 보안(security)을 참조하세요.

pnpm install && pnpm run build
pnpm test # TypeScript
pnpm run test:extension # 실제 Aseprite 내부의 Lua 핸들러
...

변경 사항을 적용하기 전에 AGENTS.md를 읽어보세요. 이곳에는 협상할 수 없는 규칙들과 이미 누군가 하루를 낭비하게 만든 Lua 함정(gotchas)들이 나열되어 있습니다.

MIT — LICENSE를 참조하세요. Aseprite는 Igara Studio S.A.의 상표이며, 이 프로젝트는 그들과 제휴하지 않습니다.

☕와 많은 Ctrl+Z로 제작되었습니다.