On this page

Getting started

Markdown

Set up Glossia in your project and run your first translation.

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:

mise use aqua:glossia.ai/cli@latest

Or install with aqua directly:

aqua g -i glossia.ai/cli@latest

Initialize your project

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

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:

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:

glossia status

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