{"id":29296277,"url":"https://github.com/3bdop/huroofai","last_synced_at":"2026-05-10T05:05:45.235Z","repository":{"id":278032699,"uuid":"912430643","full_name":"3bdop/HuroofAI","owner":"3bdop","description":"A mobile app that helps students who have some difficulties pronouncing Arabic letters","archived":false,"fork":false,"pushed_at":"2025-07-05T18:26:06.000Z","size":5926,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-05T19:47:29.511Z","etag":null,"topics":["ai","expo","ios-app","react-native"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/3bdop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-05T15:00:03.000Z","updated_at":"2025-07-05T18:26:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"d2c1f8fa-f62e-4dff-a0ca-a02d1a773749","html_url":"https://github.com/3bdop/HuroofAI","commit_stats":null,"previous_names":["3bdop/huroof-app","3bdop/huroofai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/3bdop/HuroofAI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3bdop%2FHuroofAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3bdop%2FHuroofAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3bdop%2FHuroofAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3bdop%2FHuroofAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/3bdop","download_url":"https://codeload.github.com/3bdop/HuroofAI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3bdop%2FHuroofAI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263922614,"owners_count":23530340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","expo","ios-app","react-native"],"created_at":"2025-07-06T15:09:59.317Z","updated_at":"2026-05-10T05:05:45.190Z","avatar_url":"https://github.com/3bdop.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Huroof AI 📚🎉\n\nWelcome to the Huroof app! This project is designed to help you learn some of the hardest Arabic alphabet letters in a fun and interactive way using machine learning features. The app focuses on the following letters:\n**س**،\n**ش**،\n**ر**،\n**ك**\n\n## [Demo 📹🔉](https://i.imgur.com/iaj9uPy.mp4)\n\n\u003cbr/\u003e\n\n## Prerequisites 🚀\n\nBefore you begin, make sure you have the following installed:\n\n- [Node.js](https://nodejs.org/)\n- [Expo CLI](https://docs.expo.dev/get-started/installation/)\n- A compatible Operating System: Windows, macOS, or Linux\n- [Python 3.12+](https://www.python.org/downloads/)\n\n\u003cbr/\u003e\n\n## Installation 🛠️\n\nFollow these steps to get the project up and running:\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/3bdop/Huroof-app.git\n   ```\n\n2. **Install dependencies:**\n\n   ```bash\n   npm install\n   ```\n\n3. **Start the client:**\n\n   ```bash\n   npx expo start\n   ```\n\n4. **Start the server:**\n\n   For a standard start:\n\n   ```bash\n   node server.js\n   ```\n\n   For debugging and live refresh:\n\n   ```bash\n   nodemon server.js\n   ```\n\n   \u003e **Note**: Install `nodemon` globally if you haven't already:\n   \u003e\n   \u003e ```bash\n   \u003e npm install -g nodemon\n   \u003e ```\n\n5. **Start main.py (FastAPI):**\n\n   For standard start\n\n   ```bash\n   python backend/app/main.py\n   ```\n\n   For debugging and live refresh\n\n   ```bash\n   uvicorn backend.app.main:app --reload\n   ```\n\n6. **Download the Expo Go app** on your mobile device.\n\n7. **Scan the QR code** provided by Expo to run the app on your device.\n\n\u003cbr/\u003e\n\n## Development Environment Setup 🛠️\n\nDuring development, you need to create an `env.js` file inside the [`config/`](./config/) directory with the following content:\n\n```javascript\nexport const ENV = {\n  SERVER_IP: \"\u003cyour_server_ip_here\u003e\",\n  SERVER_PORT: \"\u003cyour_server_port_here\u003e\",\n};\n```\n\n\u003cbr/\u003e\n\n## Python Model Development 🐍\n\nFollow these steps to set up the Python environment for model development:\n\n1. **Create a virtual environment:**\n\n   For Windows:\n\n   ```bash\n   python -m venv .venv\n   .\\.venv\\Scripts\\activate.bat\n   ```\n\n   For Linux/macOS:\n\n   ```bash\n   python -m venv .venv\n   source .venv/bin/activate\n   ```\n\n2. **Install Python dependencies:**\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Run Jupyter Notebooks:**\n\n   ```bash\n   jupyter notebook\n   ```\n\n   \u003e **Note**: You can also use Jupyter notebooks directly within VSCode. Install the [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter) and open your notebooks in the editor.\n\n\u003cbr/\u003e\n\n## Dev Resources\n\n- [Letter Sounds](https://www.arabicreadingcourse.com/learn-the-arabic-alphabet.php)\n\u003c!-- [Letter Picture with Example - Pinterest](https://in.pinterest.com/pin/626211523219298954/) --\u003e\n- [Letters Picture with Example](https://warq.net/2021/05/08/%D8%AD%D8%B1%D9%88%D9%81-%D8%A7%D9%84%D8%A3%D8%A8%D8%AC%D8%AF%D9%8A%D8%A9-%D8%A7%D9%84%D8%B9%D8%B1%D8%A8%D9%8A%D8%A9-%D9%85%D9%84%D9%88%D9%86%D8%A9/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3bdop%2Fhuroofai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F3bdop%2Fhuroofai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3bdop%2Fhuroofai/lists"}