{"id":19487277,"url":"https://github.com/marwan2232004/esma3nyapi","last_synced_at":"2026-02-17T14:31:31.743Z","repository":{"id":263682730,"uuid":"871322895","full_name":"marwan2232004/Esma3nyAPI","owner":"marwan2232004","description":"This project focuses on converting spoken Egyptian Arabic into written text and translating English text into Arabic. The architecture is inspired by OpenAI's Whisper model and utilizes a custom Transformer-based implementation.","archived":false,"fork":false,"pushed_at":"2025-02-03T00:13:59.000Z","size":92,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T11:57:19.019Z","etag":null,"topics":["api-gateway","asr-model","fastaapi","jupyter-notebook","machine-learning","python3","transformers","translation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marwan2232004.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-10-11T18:04:17.000Z","updated_at":"2025-02-03T00:14:03.000Z","dependencies_parsed_at":"2025-03-25T06:26:26.652Z","dependency_job_id":"7e2aa094-3fc6-4d88-a871-eb3b0a1f3f67","html_url":"https://github.com/marwan2232004/Esma3nyAPI","commit_stats":null,"previous_names":["marwan2232004/esma3nyapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marwan2232004/Esma3nyAPI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwan2232004%2FEsma3nyAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwan2232004%2FEsma3nyAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwan2232004%2FEsma3nyAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwan2232004%2FEsma3nyAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marwan2232004","download_url":"https://codeload.github.com/marwan2232004/Esma3nyAPI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwan2232004%2FEsma3nyAPI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29547377,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T13:00:00.370Z","status":"ssl_error","status_checked_at":"2026-02-17T12:57:14.072Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["api-gateway","asr-model","fastaapi","jupyter-notebook","machine-learning","python3","transformers","translation"],"created_at":"2024-11-10T20:44:57.088Z","updated_at":"2026-02-17T14:31:31.726Z","avatar_url":"https://github.com/marwan2232004.png","language":"Python","readme":"# 🌟 Esma3ny API 🌟\n\nWelcome to the ASR and Translation API! This project focuses on converting spoken Egyptian Arabic into written text and translating English text into Arabic. The architecture is inspired by OpenAI's Whisper model and utilizes a custom Transformer-based implementation.\n\nFrontend repository: [Esma3ny Frontend Repository](https://github.com/marwan2232004/Esma3ny)\n\nKaggle notebook: [Esma3ny Kaggle Notebook](https://www.kaggle.com/code/marwan2232004/speech2text-transformer)\n\n## 🚀 Features\n\n- **Automatic Speech Recognition (ASR)**: Converts spoken Egyptian Arabic into written text.\n- **Translation**: Translates English text into Arabic using the OpenL Translation API.\n- **Frontend**: Built with React Vite.\n- **Backend**: Powered by FastAPI.\n- **Deployment**: Hosted on Azure App Services and a Virtual Machine.\n\n## 📚 Architecture\n\n- **ASR Component**: Inspired by OpenAI's Whisper model, leveraging a custom Transformer-based implementation.\n- **Translation Component**: Integrates the OpenL Translation API for automatic language detection and translation from any language into Arabic.\n\n## 🛠️ Setup\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/marwan2232004/Esma3nyAPI.git\n   cd Esma3nyAPI\n2. **Install dependencies**:\n   ```bash\n   pip install -r requirements.txt\n3. **Run the server**:\n   ```bash\n   uvicorn main:app --reload\n## 📚 Deployment\n\n- The API is deployed on Azure App Services and a Virtual Machine. However, deployment is currently suspended due to costs.\n## 📄 API Endpoints\n\n- **POST /audio2text**: Converts spoken Egyptian Arabic to text.\n  - **Request**: Audio file\n  - **Response**: JSON with transcribed text\n\n- **POST /translate/en-ar**: Translates English text to Arabic.\n  - **Request**: JSON with English text\n  - **Response**: JSON with translated Arabic text\n    \n- **POST /translate/auto**: Translates from any language to Arabic.\n  - **Request**: JSON with text\n  - **Response**: JSON with translated Arabic text\n \n## ASR Transformer Architecture\n\n\n\n![Transformer_Architecture_complete drawio (1)](https://github.com/user-attachments/assets/139ad3f1-9ba0-491d-8dba-b749e8fc4e32)\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarwan2232004%2Fesma3nyapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarwan2232004%2Fesma3nyapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarwan2232004%2Fesma3nyapi/lists"}