> ## Documentation Index
> Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Bắt đầu nhanh

> Chạy hyperlocalise từ đầu đến cuối trong khoảng 10 phút.

## Mục tiêu

Tạo một `i18n.yml`, chạy lập kế hoạch dịch thuật một cách an toàn, tạo đầu ra và xem lại trạng thái.

## 1. Khởi tạo cấu hình

```bash theme={null}
hyperlocalise init
```

Điều này sẽ ghi `i18n.yml` vào thư mục hiện tại của bạn.

## 2. Cấu hình thông tin xác thực nhà cung cấp

`hyperlocalise` tự động đọc thông tin xác thực từ `.env` và `.env.local` trong thư mục dự án hiện tại của bạn. Các biến shell đã xuất vẫn được ưu tiên.

Ví dụ:

<CodeGroup>
  ```bash Export theme={null}
  export OPENAI_API_KEY="your-openai-api-key"
  ```

  ```bash .env.local theme={null}
  OPENAI_API_KEY="your-openai-api-key"
  ```
</CodeGroup>

OpenAI:

<CodeGroup>
  ```bash Export theme={null}
  export OPENAI_API_KEY="your-openai-api-key"
  ```

  ```bash .env.local theme={null}
  OPENAI_API_KEY="your-openai-api-key"
  ```
</CodeGroup>

Azure OpenAI:

<CodeGroup>
  ```bash Export theme={null}
  # Example: https://<resource>.openai.azure.com/openai/v1
  export AZURE_OPENAI_BASE_URL="https://<resource>.openai.azure.com/openai/v1"
  export AZURE_OPENAI_API_KEY="your-azure-openai-api-key"
  ```

  ```bash .env.local theme={null}
  # Example: https://<resource>.openai.azure.com/openai/v1
  AZURE_OPENAI_BASE_URL="https://<resource>.openai.azure.com/openai/v1"
  AZURE_OPENAI_API_KEY="your-azure-openai-api-key"
  ```
</CodeGroup>

Gemini:

<CodeGroup>
  ```bash Export theme={null}
  export GEMINI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai"
  export GEMINI_API_KEY="your-gemini-api-key"
  ```

  ```bash .env.local theme={null}
  GEMINI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai"
  GEMINI_API_KEY="your-gemini-api-key"
  ```
</CodeGroup>

Anthropic:

<CodeGroup>
  ```bash Export theme={null}
  export ANTHROPIC_BASE_URL="https://api.anthropic.com/v1"
  export ANTHROPIC_API_KEY="your-anthropic-api-key"
  ```

  ```bash .env.local theme={null}
  ANTHROPIC_BASE_URL="https://api.anthropic.com/v1"
  ANTHROPIC_API_KEY="your-anthropic-api-key"
  ```
</CodeGroup>

LM Studio:

<CodeGroup>
  ```bash Export theme={null}
  export LM_STUDIO_BASE_URL="http://127.0.0.1:1234/v1"
  export LM_STUDIO_API_KEY="lm-studio"
  ```

  ```bash .env.local theme={null}
  LM_STUDIO_BASE_URL="http://127.0.0.1:1234/v1"
  LM_STUDIO_API_KEY="lm-studio"
  ```
</CodeGroup>

Ollama:

<CodeGroup>
  ```bash Export theme={null}
  export OLLAMA_BASE_URL="http://127.0.0.1:11434/v1"
  export OLLAMA_API_KEY="ollama"
  ```

  ```bash .env.local theme={null}
  OLLAMA_BASE_URL="http://127.0.0.1:11434/v1"
  OLLAMA_API_KEY="ollama"
  ```
</CodeGroup>

Groq:

<CodeGroup>
  ```bash Export theme={null}
  export GROQ_BASE_URL="https://api.groq.com/openai/v1"
  export GROQ_API_KEY="your-groq-api-key"
  ```

  ```bash .env.local theme={null}
  GROQ_BASE_URL="https://api.groq.com/openai/v1"
  GROQ_API_KEY="your-groq-api-key"
  ```
</CodeGroup>

## 3. Chạy thử trước

```bash theme={null}
hyperlocalise run --dry-run
```

Kiểm tra `planned_total`, `executable_total`, và `tasks` đã được liệt kê.

## 4. Thực hiện tạo

```bash theme={null}
hyperlocalise run
```

Bản này ghi các bản dịch và cập nhật `.hyperlocalise.lock.json`. Để biết chi tiết, xem [Hợp đồng lockfile](/reference/lockfile-contract).

## 5. Trạng thái xem xét

```bash theme={null}
hyperlocalise status --output csv
```

Sử dụng `needs_review` hàng để xác định các mục vẫn cần con người biên tập.

## 6. Đánh giá chất lượng bản dịch khi cần thiết

```bash theme={null}
hyperlocalise eval run --eval-set ./eval-set.json --output ./eval-report.json
```

Dùng điều này khi so sánh các lựa chọn prompt/profile/provider hoặc trước khi triển khai các bản cập nhật dịch lớn.

## Tiếp theo

* Tinh chỉnh cấu hình trong [i18n config](/configuration/i18n-config).
* Đồng bộ với TMS của bạn bằng [sync push](/commands/sync-push) và [sync pull](/commands/sync-pull).
* Kiểm tra kỳ vọng về mức độ trưởng thành trong ma trận ổn định]\(/reference/stability-matrix).