きゃらくる / Charakuru

キャラクターのイラスト1枚から、AIエージェントと分担して VRM アバターを作るためのキットです。

English · 한국어 · 简体中文 · チュートリアル · ダウンロード（Releases） · 利用規約 · Discord

💬 Discordコミュニティに参加しよう！

Tripo公式Discordサーバーに、きゃらくる専用カテゴリを用意していただきました！

使い方の質問やフィードバック、きゃらくるで作ったアバターや作品の共有などにご利用ください。開発者のNano（ナノ）や、ほかのクリエイターとの雑談・交流も歓迎です！

きゃらくるを使ったコンテストなど、今後のイベントの告知もこちらで行う予定です。これから使ってみたい方も、制作中の方も、お気軽にどうぞ！

👉 Tripo公式Discordに参加する

参加後は、きゃらくる専用カテゴリへ！

きゃらくるとは？

Tripoのスマートメッシュを活用した、キャラクターモデリング支援キットです。

現状Tripoだけでは高品質なキャラクターモデリングは難しく、かならずワークフローの研究やBlenderの知識などが必須でしたが、このキットはそれを解決します。

Nanoが発案した独自のワークフローをローカルアプリやエージェントのSkillsに詰め込み、それをユーザーが再現できる形で配布しています。 Tripoの操作やBlenderの操作、リギングなどの難しいセットアップをGPT-6.1 SolやGPT-6 Astraに任せることができます。

人間がまだ必要な工程もありますが、Blenderを扱う必要は無く、すべてローカルアプリの簡単な操作で実現できます。 AIエージェントへの丸投げほど非現実的でもなく、すべて人力ほど難しくもない、いい感じのバランスを目指した実用的なキットです！

敷居は少し高めかも。 「ここが難しい」とか「ここが分かりづらい」とかあればissueにご意見いただけますと幸いです！

全身が映っている1枚絵を用意するだけでVRMモデルの製作が行えます。

[!WARNING] このキットは開発途中です。

ドキュメントの整備が追いついていない部分や、不具合、まだ足りない機能があります。ご了承ください。

この説明はAIが書いたものです。

人が読むには少し分かりにくいところがあります。このリポジトリ（配布ZIPの場合は展開したフォルダ）を Codex や Claude Code などのコーディングエージェントに読み込ませて、エージェントと対話しながらキットを理解するのがおすすめです。

例：「README.ja.md と AGENTS.md を読んで、このキットで何ができるか教えて」

_{作例：海月 みる。左から、元絵 → エージェントが描いた8枚の画像 → 3Dモデル → アプリの動作確認。}

---

どんなふうに進むか

制作は、アプリでの確認とチャットでの依頼を5回くり返して進みます。

1. アプリで確認したら「次へ」のボタンを押し、表示された依頼文をコピーします。
2. エージェント（Codex）とのチャットに貼り付けて送ります。
3. エージェントが作業を終えると、アプリが自動で最新の状態に切り替わり、次の確認地点で止まります。

ファイルの書き出しや読み込み、保存のやり直しは必要ありません。確認地点ではエージェントが勝手に先へ進まず、候補の決定もあなたが行います。

モデル候補はモーダルで比較し、モデル編集の「モデル候補を選ぶ」から再表示できます。モデル編集はバランス調整に集中し、三面図の大きさと足元の高さは3方向で連動します。テクスチャ生成後に別の候補を採用すると、元のプロジェクトを残してコピーに分岐します。完成VRMは動作確認画面の最後から保存します。

画像を確認 頭（髪込み）と体を4方向ずつ。1枚だけ直す依頼もできます。	3Dの候補を選ぶ 頭と体それぞれ4つの候補を回して見比べます。	動きを確認 歩行モーションで肩や膝の曲がり方を確かめます。

設計の考え方

• 人は判断、エージェントは作業。 あなたの担当は、元絵の登録、画像の確認、候補の決定、頭身の調整、動作確認の5つです。その間の分離・分類・書き出し・登録はエージェントが行い、あなたの宿題にしません。
• 確認地点で必ず止まる。 候補をどれにするかをエージェントが決めることはありません。見た目の判断が必要な場面では、エージェントが画面を示して確認を求めます。
• 制作の記録は1つ。 プロジェクトは project.charakit 1つに保存され、日付付きのコピーや「final2」のようなファイルは増えません。アプリを同じフォルダから起動し直すと、前回の続きが開きます。
• 手元で動く。 アプリはパソコン上で起動するローカルアプリで、npm install なしで動きます。画像生成やTripoなどの外部サービスは、あなた自身のアカウントで使います。

必要なもの

	用途
Node.js 22 以上	アプリの起動に使います。
デスクトップの Chromium 系ブラウザー（Chrome など）	アプリを開きます。
Codex（画像生成とブラウザー操作が使える環境）	制作を担当するエージェントです。画像を描き、Tripoをブラウザーで操作し、Blenderを動かします。
Tripo のアカウント（ログイン済みのブラウザー）	3Dモデルの候補生成、テクスチャの再生成、リギングに使います。
Blender 5.2、VRM Add-on for Blender、Blender MCP	ウェイト、揺れもの、VRMの書き出しに使います。
自分が使ってよい元絵	PNG / JPEG / WebP、20MBまで。全身の分かる設定画のようなものが向いています。

外部サービスのアカウント、利用条件、料金・クレジットはそれぞれのサービスのものです。足りない準備は、エージェントが最初に確認して教えてくれます。

はじめかた

1. Releases から charakuru-1.1.0-….zip をダウンロードし、書き込みできる好きなフォルダに展開します。
   _{※ GitHubが自動で付ける「Source code」のZIPは説明文書だけで、キットは入っていません。}

2. Codex で展開したフォルダを開き、次のように頼みます。

   ルートAGENTS.mdを読んで、このキットでキャラクター制作を始めたい
   

3. エージェントが環境を確認してアプリを起動します。表示された http://127.0.0.1:8766 をブラウザーで開けば準備完了です。

自分で起動する場合は、展開したフォルダで npm start を実行します。アプリは最初は英語で表示されます。左下の Settings を開き、Language の選択欄で日本語・English・한국어・简体中文を選べます。依頼文とエージェントの説明・進捗・結果は選択言語に合わせます。

続きは チュートリアル で、1体目を作り終えるまでの手順を画面つきで説明しています。

新しい依頼文は、Windows の Codex が旧形式の start とURLをURL起動命令と誤判定しないよう、開始命令に begin を使います。古い依頼文が blocked by policy と拒否された場合は、復旧手順を確認し、更新済みキットのアプリから依頼文をコピーし直してください。

キットの中身

AGENTS.md	エージェントが最初に読む入口です。必要な環境、工程、保存のルールをまとめています。
public/、server.mjs	確認用のローカルアプリです。
skills/	制作工程に使う9つのSkillsです。
scripts/	エージェントがプロジェクトを更新するためのスクリプトです。
assets/donor/weighted-body.blend	ウェイト転送に使う素体です。
docs/	チュートリアル、動作確認の使い方、日本語・英語・韓国語・簡体字中国語の利用規約の解説です。

9つのSkills

Skill	使う場面
charakit-project	プロジェクトファイルの検査・読み込み・更新
character-parts-images	元絵から頭（髪込み）と体を4方向ずつ、計8枚描く
character-three-views	バランス調整用の全身三面図の制作
character-material-brushup	形とデザインを保ったまま、塗りと質感を仕上げる
tripo-agent-workflow	Tripoでの候補生成、部位の分類、UV展開とテクスチャ、リギング
tripo-studio-download	Tripo Studioから書き出したモデルの受け取りと保存ファイルの確認
avatar-weight-transfer	揺れものの分離と、素体からのウェイト転送
avatar-spring-setup	髪や衣装の揺れもの設定と、VRMの書き出し・確認
tripo-character-setup	関節の目印を自分で置く詳しいリギング（選んだときだけ使う）

現在の制約

• 依頼文をコピーしただけではエージェントは動きません。チャットに貼って送ってください。作業中はアプリを開いたままにします。
• 新しく作るキャラクターは通常の顔・固定視線から始まります。任意の「表情制作」タブで表情を制作・読み込みできます。視線の動きは含みません。
• 動作確認は、モデル情報が未登録でも検査済みVRMを自動表示します。歩行と物理は最初から有効です。見た目の良し悪しはあなたが判断します。
• 「VRMを書き出す」でモデル情報の画面を開きます。モデル名・作者名・利用条件を確認し、「登録して書き出す」で情報の保存とダウンロードまで進みます。形状・材質・揺れものは動作確認と同じで、情報はプロジェクトに保存して次回の書き出しで再利用します。依頼文のコピーは不要です。
• 持ち運ぶときは、project.charakit だけでなく、完成した VRM や Blend ファイルの入った制作フォルダもまとめて保管してください。

利用規約

非商用・商用を問わず、以下の条件内であれば自由にお使いいただけます。

キットの再配布や、キットのコードを利用者へ提供する製品・サービスへの組み込みは、事前にNanoまでご相談ください。

私的な改変や複製はOKです。

同梱素材だけを抜き出して外部へ持ち出したり、再配布したりすることは禁止です。

法律で認められる範囲で、このキットの利用によって発生した損害の責任を負いません。

事業全体の年商と累計調達資金がどちらも1億円未満であれば、通常のライセンスの条件内で、別途契約や登録なしに利用できます。どちらかが1億円以上の場合は、商用・業務利用を開始・継続する前に、Nanoを窓口として権利者等との別途の書面によるライセンス契約を締結してください。売上と調達資金は合算しません。

年商は直近の終了した会計年度で判定します。会計年度がない場合は直近12か月、まだ会計年度が終了していない場合は開業後の実売上（最大直近12か月）を使い、開業後12か月未満の場合や短い初年度は年換算しません。累計調達資金は年度に関係なく受領時に再確認します。詳しい計算方法と契約のタイミングは利用規約の解説をご覧ください。

正式なライセンスはこちらをご覧ください。

不具合の報告

うまくいかなかった工程や改善案は、報告方法 に沿って Issues へお願いします。プルリクエストは受け付けていません。

---

_{Made by Nano（ナノ） · sponsored by Tripo}

表情制作

リギングの次にある「表情制作」タブの最上部から、エージェントへの依頼文をコピーできます。VRM 0.x／1.0・GLBを読み込むか、キャラキットを開き直し、表情一覧から選んで強度・最小値・最大値を調整します。表情がなければ調整欄は無効です。複数の表情を組み合わせて確認でき、読み込んだ元モデル・選択・調整値をキットに保存します。独自の表情名も保持します。このプレビュー設定で元VRMは書き換えません。

Codexが同梱知識と道具を使い、皮膚だけの目マスク、上下を分けた口縁の動き、独立した眉のポーズを転送します。対応はエージェントがモデルを見て決め、比較とBlender編集で自然で可愛い表情へ仕上げます。同梱は8眼・10口・5眉です。固定多方向撮影・途中強度・重ね合わせを使い、転送や保存の成功を見た目の合格にはしません。元の形状・UV・材質・既存表情を保持し、任意のBlend・GLB・比較資料を同じプロジェクトへ返します。既存VRMは変更しません。説明を参照してください。Blender 5.2以降とMToon表示用VRM Add-onを使い、局所の仕上げにはComputer Useも使えます。表情素材はキット制作者本人の制作物で、他の同梱素材と同じく素材単体の持ち出し・再配布は禁止です。