esoterica

esoterica is a modular, high-performance Rust framework for generating constructed languages (conlangs). It allows users to create consistent languages by composing independent linguistic components: phonology, morphology, and syntax.

Features

• Component-based Generation: Dynamically mix-and-match phonological, morphological, and syntactic profiles to create diverse languages.
• Rule-based Synthesis:
  • Phonology Engine: Generates syllables based on custom phonotactic patterns (e.g., C(C)V(C)) with support for tone and vowel harmony.
  • Morphology Engine: Supports complex transformation rules including Suffix/Prefix/Infix insertion and Reduplication.
  • Sound Change Engine: Simulates diachronic phonological shifts for historical consistency.
• CLI Interface: Generate complex language packages directly from the command line.
• Interactive TUI: Real-time conlang generation and configuration.
• ATProto Publication: Publish generated lexicons directly to the ATProto network using site.standard.document schemas.

Quick Start

1. Build the project:

   cargo build --release
   

2. Run in Interactive TUI Mode:

   cargo run --release -- --interactive
   

   Navigate with Tab, input configurations, and press Enter to generate.

3. Generate via CLI:

   cargo run --release -- --phonology uralic_finnic --morphology agglutinative --syntax svo --output my_language.json
   

ATProto Publication

To publish your generated lexicon to ATProto, you need to use an App Password (not your main account password).

1. Get an App Password: https://bsky.app/settings/app-passwords
2. Configure the following environment variables:

   export ATPROTO_HANDLE="your-handle.bsky.social"
   export ATPROTO_PASSWORD="your-app-password"
   

3. Run the generator with the publication flag:

   cargo run --release -- \
     --phonology uralic_finnic \
     --morphology agglutinative \
     --syntax svo \
     --publish-title "My New Language" \
     --publication-uri "at://did:plc:.../site.standard.publication/..."
   

Project Structure

• src/main.rs: CLI and orchestration logic
• src/archetypes.rs: Registry of linguistic components
• src/phonology.rs: Syllable and word generation engine
• src/morphology.rs: Morphological transformation engine
• src/sound_change.rs: Diachronic sound change simulation
• src/syntax.rs: Word order management
• src/lexicon.rs: Dictionary generation and management
• src/tui.rs: Ratatui interactive interface
• src/atproto.rs: ATProto publishing logic

Licence

MIT License — see repository.