This tutorial walks you through installing Glossia, creating a configuration file, and running your first content translation.

## Prerequisites

- A project with content files (Markdown, JSON, YAML, or PO)
- An API key for at least one LLM provider (OpenAI, Anthropic, or Vertex AI)

## Install Glossia

Install with mise:

```bash
mise use aqua:glossia.ai/cli@latest
```

Or install with aqua directly:

```bash
aqua g -i glossia.ai/cli@latest
```

## Initialize your project

Run the init command to set up a `GLOSSIA.md` configuration file:

```bash
glossia init
```

This launches an interactive agent that scans your project, asks about your goals, and writes a working `GLOSSIA.md` at the project root.

## Run your first translation

Once `GLOSSIA.md` is in place, translate your content:

```bash
glossia translate
```

Glossia reads your source files, sends them to the configured model, validates the output, and writes the translated files to the paths defined in your configuration.

## Check the results

Review what Glossia produced:

```bash
glossia status
```

This shows which files are up to date, which are stale, and which are missing.