Metadata-Version: 2.4
Name: vaantamil
Version: 0.1.2
Summary: Tamil Morphological Analyzer and Grammar Engine
Author-email: Priya Saravanan <writemailtovaantamil@gmail.com>
Project-URL: Homepage, https://vaantamil.com
Project-URL: Source, https://github.com/vaantamil/vaantamil
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# vaantamil

**VaanTamil** is a deterministic Tamil Morphological Analyzer and Grammar Engine designed for
accurate, explainable Tamil language processing.

The project focuses on rule-based NLP with zero hallucination and full grammatical transparency.

---

## Features

- Deterministic, rule-based Tamil morphology
- Verb analysis (tense, person, number, gender)
- Conjunctive stem handling
- Explainable word and morpheme splits
- Suitable for spell-checking and grammar tools
- Designed for high-performance engines

---

## Installation

```bash
pip install vaantamil
```

Requires **Python 3.9+**

---

## Usage

Run as a module:

```bash
python -m vaantamil
```

Import as a library:

```python
import vaantamil
```

---

## Example

```text
செய்கிறேன்
→ செய் + க் + இன்று + ஏன்
→ Verb (Present Tense, 1st Person Singular)
```

All outputs are structurally explainable.

---

## Project Goals

- Build a transparent Tamil grammar engine
- Preserve classical and modern Tamil grammar rules
- Enable grammar-aware spell checking
- Support editor and browser integrations
- Enable WASM-based deployment

---

## Roadmap

- Verb analyzer CLI
- Full noun morphology
- Spell-tolerant parsing
- WASM builds for browser use
- Editor integrations
- Public REST API

---

## Links

- Website: https://vaantamil.com
- YouTube: https://www.youtube.com/@VaanTamilAI

---

## License

MIT License

---

## Author

Priya Saravanan  
Senior Software Engineer | AI & NLP

---

VaanTamil — making Tamil grammar computable, explainable, and reliable.
