Metadata-Version: 2.4
Name: cat-translate-cli
Version: 0.2.0
Summary: CAT-Translate-7b GGUF モデルを使った日英・英日翻訳CLIツール（サーバーモード対応）
Project-URL: Homepage, https://github.com/Shuichi346/cat-translate-cli
Project-URL: Repository, https://github.com/Shuichi346/cat-translate-cli
Project-URL: Issues, https://github.com/Shuichi346/cat-translate-cli/issues
Author-email: Shuichi <your-email@example.com>
License-Expression: MIT
License-File: LICENSE
Keywords: cli,english,gguf,japanese,llama-cpp,llm,translation
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.10
Requires-Dist: gradio>=6.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: huggingface-hub>=0.27.0
Requires-Dist: llama-cpp-python>=0.3.2
Description-Content-Type: text/markdown

<table>
  <thead>
    <tr>
      <th style='text-align:center'><a href='README_en.md'>English</a></th>
      <th style='text-align:center'><a href='README.md'>日本語</a></th>
    </tr>
  </thead>
</table>

# cat-translate-cli

[CAT-Translate-7b](https://huggingface.co/cyberagent/CAT-Translate-7b) の量子化 GGUF モデルを使った、日英・英日翻訳の CLI ツールです。

Apple Silicon (Metal) に対応しており、Mac でローカル実行できます。

**サーバーモード**を使うと、モデルを常駐させてブラウザからも CLI からも高速に翻訳できます。

## 必要なもの

- macOS（Apple Silicon 推奨）
- Python 3.10 以上
- [uv](https://docs.astral.sh/uv/)（Python パッケージマネージャー）
- Xcode Command Line Tools（`xcode-select --install`）

## インストール

```bash
# リポジトリをクローン
git clone https://github.com/yourname/cat-translate-cli.git
cd cat-translate-cli

# Metal（GPU）対応でインストール
CMAKE_ARGS='-DGGML_METAL=on' uv sync

# 仮想環境アクティブ
source .venv/bin/activate
```

> **注意**: `llama-cpp-python` は C++ のビルドが必要です。
> Apple Silicon で GPU を使うには `CMAKE_ARGS='-DGGML_METAL=on'` を付けてください。

## 使い方

### CLI（コマンドライン）

```bash
# 日本語 → 英語（言語は自動判定）
cat-translate '猫はとてもかわいいです。'

# 英語 → 日本語（言語は自動判定）
cat-translate 'Cats are very cute.'

# 翻訳先の言語を指定（ja / en の短縮形が使えます）
cat-translate 'Hello, world!' --to ja
cat-translate 'こんにちは' --to en

# フルネームでも OK
cat-translate 'Hello, world!' --to Japanese

# 原文の言語も明示的に指定
cat-translate 'Hello!' --from en --to ja

# ファイルから翻訳
cat-translate --file input.txt

# パイプ入力
echo 'こんにちは世界' | cat-translate

# 翻訳結果だけリダイレクト（ログは出ません）
cat-translate '猫はかわいい' > output.txt
```

### サーバーモード（高速翻訳）

サーバーを起動すると、モデルが常駐するため CLI での翻訳が大幅に高速化します。
ブラウザからも Web UI で翻訳できます。

```bash
# ターミナル1: サーバーを起動（初回のみモデル読み込みに時間がかかります）
cat-translate-server

# ターミナル2: CLI で翻訳（サーバーが起動中なら自動的にサーバー経由）
cat-translate '猫はとてもかわいいです。'

# ブラウザで Web UI を開く
# → http://127.0.0.1:7860
```

サーバーが起動していない場合は、従来通りローカルでモデルを読み込んで翻訳します。

```bash
# サーバーを使わず、常にローカルで翻訳
cat-translate '猫はかわいい' --no-server
```

### 主なオプション（CLI）

| オプション | 説明 | デフォルト |
|---|---|---|
| `--from LANG` | 原文の言語（ja / en / Japanese / English） | 自動判定 |
| `--to LANG` | 翻訳先の言語（ja / en / Japanese / English） | 自動判定 |
| `--model` | GGUF ファイル名 | `CAT-Translate-7b.i1-Q4_K_M.gguf` |
| `--model-path` | ローカルの GGUF ファイルパス | なし（HF からダウンロード） |
| `--repo-id` | Hugging Face リポジトリ ID | `mradermacher/CAT-Translate-7b-i1-GGUF` |
| `--n-gpu-layers` | GPU に載せるレイヤー数 | `-1`（全レイヤー） |
| `--n-ctx` | コンテキストウィンドウサイズ | `4096` |
| `--max-tokens` | 最大生成トークン数 | `2048` |
| `--verbose` | 詳細ログを表示 | オフ |
| `--server-url` | 翻訳サーバーの URL | `http://127.0.0.1:7860` |
| `--no-server` | サーバーを使わずローカルで翻訳 | オフ |

### 主なオプション（サーバー）

| オプション | 説明 | デフォルト |
|---|---|---|
| `--host` | サーバーのホスト | `127.0.0.1` |
| `--port` | サーバーのポート | `7860` |
| `--model` | GGUF ファイル名 | `CAT-Translate-7b.i1-Q4_K_M.gguf` |
| `--model-path` | ローカルの GGUF ファイルパス | なし |
| `--n-gpu-layers` | GPU に載せるレイヤー数 | `-1` |
| `--n-ctx` | コンテキストウィンドウサイズ | `4096` |
| `--max-tokens` | 最大生成トークン数 | `2048` |
| `--verbose` | 詳細ログを表示 | オフ |

### 別の量子化モデルを使う

```bash
# 軽量モデル（Q2_K）を使う場合
cat-translate 'こんにちは' --model CAT-Translate-7b.i1-Q2_K.gguf

# 高品質モデル（Q6_K）を使う場合
cat-translate 'こんにちは' --model CAT-Translate-7b.i1-Q6_K.gguf
```

### CPU のみで実行する場合

```bash
cat-translate 'こんにちは' --n-gpu-layers 0
```

### トラブルシューティング

動作がおかしい場合は `--verbose` を付けて詳細ログを確認してください。

```bash
cat-translate '猫はかわいい' --verbose
```

## モデルについて

- **元モデル**: [cyberagent/CAT-Translate-7b](https://huggingface.co/cyberagent/CAT-Translate-7b)（MIT License）
- **GGUF 量子化**: [mradermacher/CAT-Translate-7b-i1-GGUF](https://huggingface.co/mradermacher/CAT-Translate-7b-i1-GGUF)
- **デフォルト量子化**: `i1-Q4_K_M`（約 4.6 GB、速度と品質のバランスが良い）
- 初回実行時にモデルが自動ダウンロードされます（`~/.cache/huggingface/` に保存）

## ライセンス

MIT License