Hebrew Graded Reader

Assessing the readability of Hebrew pericopes

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Roadmap
4. Contributing
5. License
6. Contact
7. Acknowledgments

About The Project

This project is a joint research effort of Seth Howell and Dr. Jesse Scheumann that aims to assess the difficulty of Hebrew passages by considering various linguistic factors such as word frequency, morphological complexity, syntactic complexity, verb types, vocabulary diversity, semantic complexity, text genre, and thematic familiarity.

Built With

• Python
• Django

Getting Started

To get a local copy up and running, follow these steps:

Prerequisites

• Python 3.9 or higher
• pip
• npm

Installation

1. Clone the repo

   git clone https://github.com/Tanakh-Reader/graded-reader.git

2. Install required packages

   npm run sync

3. Run the app

   npm run start

Usage

Run the app and head to http://127.0.0.1:8000/ to utilize the features.

Roadmap

• Develop initial metrics for assessing Hebrew passage difficulty
• Improve and refine metrics
• Implement a user-friendly interface
• Optimize performance and efficiency

Contributing

Contributions are welcome and appreciated! To contribute:

1. Fork the project
2. Create your feature branch (git checkout -b feature/YourFeature)
3. Commit your changes (git commit -m 'Add YourFeature')
4. Push to the branch (git push origin feature/YourFeature)
5. Open a pull request

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Contact

Seth Howell - hebrewliteracyapp@gmail.com

Project Link: https://github.com/Tanakh-Reader/graded-reader.git

Acknowledgments

• Dr. Jesse Scheumann
• James Tauber
• GPT 4
• README-Template

(back to top)