Locadex — AI i18n エンジニア

npx locadex start

Next.jsアプリをフランス語、スペイン語、日本語、またはその他の言語に翻訳するのは面倒で時間がかかります。

LocadexはClaude搭載のオープンソースエージェントで、国際化（i18n）作業の100%を代行するために構築されています。

これには以下が含まれます：

gt-next i18nライブラリを使用するためのプロジェクト設定
多言語コンテンツをサポートするためのReactコンポーネントと文字列の修正
必要な数の言語へのアプリの翻訳

CLIツールとしてインストールするか、Github Actionとして設定することができます。

はじめに

1. APIキーの設定

Locadexを実行する前に、APIキーを設定する必要があります。ターミナルで環境変数として設定できます：

Terminal

export ANTHROPIC_API_KEY="<Your Anthropic API Key>"
export GT_API_KEY="<Your GT Production API Key>"
export GT_PROJECT_ID="<Your GT Project ID>"

または、プロジェクトのルートディレクトリに以下の内容で.envファイルを作成することもできます：

.env

ANTHROPIC_API_KEY="<Your Anthropic API Key>"
GT_API_KEY="<Your GT Production API Key>"
GT_PROJECT_ID="<Your GT Project ID>"

APIキーはダッシュボードから取得できます。

2. Locadex CLIの実行

最も簡単な始め方は、プロジェクトのルートディレクトリで以下のコマンドを実行することです：

npx locadex start

この単一のコマンドで：

locadexとgt-nextをインストール
プロジェクト内のすべてのファイルを完全に国際化
ビルドスクリプトにtranslateコマンドを追加
プロジェクトのCIワークフローにlocadex Github Actionを追加
プロダクション品質の翻訳でプロジェクトを完全に翻訳（GT APIキーを提供した場合）

プロジェクトのサイズによっては、このエージェントの完了に時間がかかる場合があります。keep-aliveターミナルセッションで実行することをお勧めします。

3. 継続的国際化

Locadexは継続的国際化のためのGithubアクションとしても設定できます。リポジトリに変更をプッシュするたびに、アプリが自動的に国際化されます。

プロジェクトがgt-nextライブラリでi18nに対応していることを確認してください！これを行う最も簡単な方法は、まずプロジェクトでnpx locadex startを実行することです！

.github/workflows/locadex.ymlファイルに以下を追加してください：

.github/workflows/locadex.yml

name: Run Locadex

on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: write
  pull-requests: write

jobs:
  locadex:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
      - name: Run Locadex
        uses: generaltranslation/locadex@v0
        with:
          api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          gt_api_key: ${{ secrets.GT_API_KEY }}
          gt_project_id: ${{ secrets.GT_PROJECT_ID }}

このワークフローがトリガーされるたびに、Locadexはプロジェクトに加えた変更を自動的に国際化し、変更内容でプルリクエストを作成します。

このワークフローをニーズに合わせて自由にカスタマイズしてください。

要件

Node.js 18+
git 2.23+

次のステップ

より多くの設定オプションについては、Github Actionのドキュメントをご覧ください
Locadexの使用方法に関するヒントについては、Tips and Tricksページをご覧ください
モノレポでLocadexを使用する方法については、Monorepoページをご覧ください