A web application for studying Ancient Greek texts with integrated lexical, syntactic, and morphological analysis tools.

Oxytone provides an interactive reading environment for Ancient Greek texts with:

• Integration with LSJ dictionary (taken from Giuseppe Celano's Unicode version)
• Morphological analysis and highlighting of verb complements
• Flashcard generation for vocabulary learning via Anki

Oxytone includes the full GLAUx corpus, which contains most Ancient Greek texts. However, most of these texts have been annotated automatically through machine learning. See Keersmaekers, Alek (2021) for more details and a breakdown of annotation accuracy. GLAUx itself is based on the hard work of the people behind the Perseus and Perseids Projects, along many others.

oxytone/
  webapp/           # BaseX RESTXQ endpoints
  repo/             # XQuery modules
  seed/             # XQuery seeding scripts
  app/              # Python FastAPI backend (for Anki flashcards)
  src/              # SvelteKit frontend
  static/           # Static assets for SvelteKit
  glaux/            # GLAUx corpus files
  tei/              # TEI corpus files
  lsj/              # LSJ dictionary resources

Follow the installation instructions on their respective websites:

• basex: XML database
• uv: Python package manager (if you wish to work on the flashcards functionality)
• pnpm: JavaScript package manager
• just: Task runner
• Saxon-HE: XSLT processor for BaseX (this can be installed automatically with just saxon)

# Install dependencies
uv venv # create Python venv
source .venv/bin/activate.sh # might be different based on your shell
just install

# Seed the databases
just seed

See CLAUDE.md for more detailed development guidelines.