Telugu Chandassu Identifier (telugu-chandassu)

A rule-based Python engine for identifying and analyzing Telugu prosodic meters (ఛందస్సు). It classifies Laghu (లఘువు) and Guru (గురువు) weights and matches Vritta (వృత్తం), Jati (జాతి), and Upajati (ఉపజాతి) padyam with detailed Gana, Yati, and Prasa breakdowns.

Installation

Core Library (Zero External Dependencies)

pip install telugu-chandassu

With Interactive Streamlit App

pip install "telugu-chandassu[app]"

For Development & Testing

pip install "telugu-chandassu[dev]"

Supported Meters

Vritta (వృత్తం — Syllabic / 3-akshara ganas)

Jati (జాతి — Matra-based with Surya/Indra ganas, Prasa required)

Upajati (ఉపజాతి — Matra-based, Prasa not required, Prasa-Yati allowed)

Usage

from telugu_chandas import ChandasEngine

engine = ChandasEngine()

poem_text = """భవదున్మేషవిజృంభణంబు పరికింపంగా సరోజాతసం-
భవు జన్మంబు భవన్నిమేష మమితబ్రహ్మాండకల్పాంత భై-
రవసంక్షోభిత మన్నఁ దక్కిన భవత్ప్రారంభభూరిక్రియా-
నివహం బెవ్వరు నేర్తు రిట్టిదని వర్ణింపంగ సర్వేశ్వరా!"""

# 1. Identify Meter
result = engine.identify_meter(poem_text)
print("Meter Name     :", result.meter_name)       # "Mattebham"
print("Confidence     :", result.confidence)       # "95.0%"
print("Yati Valid     :", result.yati_valid)       # True
print("Prasa Valid    :", result.prasa_valid)      # True
print("Ganas Found    :", result.ganas_found)      # ['Sa', 'Bha', 'Ra', 'Na', 'Ma', 'Ya', 'Va']
print("Prasa Consonant:", result.prasa_note)       # Main Prasa: వ

# 2. Analyze Individual Aksharas & Weights
tokens = engine.analyze(poem_text)
for token in tokens:
    if token.is_word:
        for ak in token.aksharas:
            print(f"{ak.text}: {ak.weight.value}")  # e.g. "భ": "I", "వ": "I", "దు": "U"

# 3. Debug Output
print(engine.debug_output(poem_text))

Running the Web UI

If installed with the [app] extra or from source:

streamlit run app.py

Running Tests

pytest tests/ -v

License

This project is licensed under the GNU Affero General Public License v3 (AGPL-3.0).