Soju (소주) Platform

An experimental Korean language learning platform: vocabulary, grammar, and practice in one place. This guide covers running the site, validating data, and using the Python CLIs. There is no Python API / class reference.

Documentation

Introduction

• Getting started
• Adding vocabulary
• Adding verbs

CLI reference

• soju (unified entry)
• soju import
• soju promote
• soju levels
• soju validate-schemas
• soju align
• soju registry
• soju translate-words
• soju fill-examples
• soju fill-verbs
• soju embed-index
• soju backend

Development

• Run the site
• AI practice & chat
• Local TTS (speech)
• Static build (GitHub Pages)
• Validate data
• Import vocabulary
• Local Python setup
• Build the documentation
• Editor support
• Agent notes
• Data layout (overview)
• Poe tasks (shortcuts)
• Docker
• Libraries Used