## معرفی هضم

[هضم](https://www.roshan-ai.ir/hazm) **کتابخانه‌ای پایتونی برای پردازش زبان
فارسی** است. با هضم می‌توانید متن را نرمال‌سازی کنید. جملات و واژه‌های متن را
استخراج کنید. ریشهٔ کلمات را پیدا کنید. جملات را تحلیل صرفی و نحوی کنید.
وابستگی‌های دستوری را در متن شناسایی کنید و ... .

!!! info "مبتنی بر کتابخانهٔ nltk و سازگار با پایتون {{needed_python_version() | to_persian_numeral}}"
هضم بر مبنای کتابخانهٔ [NLTK](https://www.nltk.org/) توسعه داده شده و برای
**زبان فارسی** بومی‌سازی شده است. هضم با پایتون {{needed_python_version() | to_persian_numeral}} سازگار است.

!!! info "محصولی از تیم روشن"
این کتابخانه در ابتدا به عنوان پروژه‌ای شخصی توسعه داده شد و اکنون زیر چتر
[محصولات روشن](https://www.roshan-ai.ir/) در ادامهٔ مسیر توسعه است.

<figure markdown>
  ![کتابخانهٔ هضم](assets/sample.png){ loading=lazy }
  <figcaption></figcaption>
</figure>

## نصب هضم

ابتدا پکیج هضم را نصب کنید:

```console
$ pip install hazm
```

سپس [منابع موردنظر را دانلود کنید]({{pretrained_models}}) و ترجیحاً در ریشهٔ پروژه اکسترکت کنید.

و در آخر، هضم را را در پروژه خود ایمپورت کنید:

```py
from hazm import *
```

## استفاده از هضم

کد پایین دیدی کلی از کاربردهای هضم نشان می‌دهد:

{{hazm_code_example()}}

جزئیات بیشترِ این توابع را در بخش [کلاس‌ها و توابع](content/hazm/index.md) پی بگیرید.
هضم علاوه بر کلاس‌ها و توابع مختص خود، کلاس‌ها و توابعی نیز برای خواندن
پیکره‌های مشهور دارد که می‌توانید توضیحات هریک از آن‌ها را در بخش
[پیکره‌خوان‌ها ](content/hazm/corpus_readers/index.md)بخوانید. هضم مبتنی بر پایتون است؛ با این حال
نسخه‌هایی از این کتابخانه به زبان‌های دیگر [پورت شده است](content/in-other-languages.md).
