# Kakutey Installer

> Download and set up the kakutey bookkeeping application from GitHub. Run once before first use or after major updates to reinstall dependencies. Use when this capability is needed.

- Skill: `tomevault-io/kakutey-installer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/kakutey-installer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/kakutey-installer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/kakutey-installer

---


# kakutey-installer

kakutey アプリを GitHub からダウンロードし、依存関係をセットアップする。

## 前提条件

| ツール | バージョン | インストール |
|--------|-----------|-------------|
| Node.js | v22.12.0 以上 | https://nodejs.org/ |
| Python | 3.12 以上 | https://www.python.org/ |
| uv | 最新 | https://docs.astral.sh/uv/getting-started/installation/ |

## 使い方

```bash
# カレントディレクトリに kakutey/ を作成
python3 scripts/install.py

# 親ディレクトリを指定（kakutey/ は自動付加される）
python3 scripts/install.py /path/to/parent
# → /path/to/parent/kakutey/ にインストールされる
```

**重要**: インストール先は必ず `kakutey/` フォルダにまとめられる。引数に指定したパスの末尾が `kakutey` でない場合、自動的に `kakutey/` が付加される。ユーザーの作業ディレクトリ直下にアプリファイルを展開してはならない。

## 処理の流れ

1. 前提条件（node, python, uv）のバージョンチェック
2. GitHub から kakutey ソースコードの zip をダウンロード・展開
3. バックエンド依存関係のインストール（`uv sync`）
4. フロントエンド依存関係のインストール（`npm install`）

## インストール後

完了メッセージに表示される `KAKUTEY_FRONTEND_DIR` を環境変数に設定すれば、kakutey-launcher でアプリを起動できる。

## 注意

- インターネット接続が必要
- すでにインストール先が存在する場合はソースコードを上書き更新する（`node_modules/` や `.venv/` は保持）
- インストール先に kakutey 以外のファイルが存在する場合はエラーで中止する
- macOS / Linux / Windows 対応

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/usa-tech-lab) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->