LO-Solver

An AI-powered Linguistics Olympiad solver built with Mastra. This project uses agentic workflows to analyze and solve Rosetta Stone-style linguistics puzzles—the kind found in competitions like the International Linguistics Olympiad (IOL), UK Linguistics Olympiad (UKLO), and North American Computational Linguistics Olympiad (NACLO).

Overview

Rosetta Stone problems present sentences in an unfamiliar language alongside their translations. Solvers must deduce the underlying grammatical rules and vocabulary to translate new sentences. This project automates that process using multi-agent AI workflows.

How It Works

[TBC]

Project Structure

[TBC]

Getting Started

Prerequisites

• Node.js ≥ 22.13.0
• An OpenRouter API key

Installation

npm install

Configuration

Create a .env file based on .env.example:

cp .env.example .env

Add your API keys to the .env file.

Running

Start the Mastra development server:

npm run dev

To start fresh (clears the database):

npm run dev:new

Example Problems

The examples/ directory contains sample problems from linguistics olympiads:

• Forest Enets (IOL 2024) – Uralic language from Northern Siberia
• Okinawan (IOL 2024) – Japonic language from Japan
• Saisiyat (UKLO 2025) – Austronesian language from Taiwan

Technologies

• Mastra – AI agent orchestration framework
• TypeScript – Type-safe development
• Zod – Schema validation
• OpenRouter – LLM provider abstraction

License

This project is for educational and research purposes.