{"id":27771570,"url":"https://github.com/el-ouardy/atlaslingua","last_synced_at":"2025-10-06T22:28:32.847Z","repository":{"id":257570495,"uuid":"817477913","full_name":"EL-OUARDY/AtlasLingua","owner":"EL-OUARDY","description":"The project aims to address the lack of online services that provide translation assistance for English speakers learning Moroccan Darija.","archived":false,"fork":false,"pushed_at":"2025-03-09T10:55:48.000Z","size":3966,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-29T22:43:33.112Z","etag":null,"topics":["ai","flask","llm","nlp","python","react","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://atlaslingua.com/","language":"TypeScript","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/EL-OUARDY.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}},"created_at":"2024-06-19T19:53:14.000Z","updated_at":"2025-04-28T08:47:49.000Z","dependencies_parsed_at":"2024-12-15T12:23:14.282Z","dependency_job_id":"4aa8dff0-fd05-4835-b062-f9212ea622c7","html_url":"https://github.com/EL-OUARDY/AtlasLingua","commit_stats":null,"previous_names":["el-ouardy/atlaslingua"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EL-OUARDY%2FAtlasLingua","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EL-OUARDY%2FAtlasLingua/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EL-OUARDY%2FAtlasLingua/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EL-OUARDY%2FAtlasLingua/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EL-OUARDY","download_url":"https://codeload.github.com/EL-OUARDY/AtlasLingua/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251596613,"owners_count":21615014,"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","flask","llm","nlp","python","react","tailwindcss","typescript"],"created_at":"2025-04-29T22:43:38.680Z","updated_at":"2025-10-06T22:28:27.816Z","avatar_url":"https://github.com/EL-OUARDY.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# English ⇔ Darija Translator Project\n\n### “Advanced and Accurate English-Moroccan Darija Translation”\n\n`ReactJS`\n`Python`\n`TypeScript`\n`Flask`\n`Firebase`\n`TailwindCSS`\n`Shadcn/ui`\n\n![English ⇔ Darija Translator Project](/screenshot.png)\n\n## Table of Contents\n\n- [Overview](#overview)\n- [The Problem](#the-problem)\n- [Tech Stack](#tech-stack)\n- [Installation](#installation)\n- [About me](#about)\n- [Contact](#contact-me)\n\n# Overview\n\nThis project is more than just a technical demonstration – it's a tool designed to bridge communication gaps and support cultural exchange. As a Moroccan software engineer, I've poured my heart and expertise into creating a resource that will be truly useful for both visitors to Morocco and those interested in learning our unique dialect.\n\nThis project combines my passion for technology with a desire to contribute meaningfully to the community. It represents not just what I've learned, but also my vision for how software can solve real-world problems and bring people together.\n\nI started this as my final portfolio submission for the **ALX** Software Engineering program (**Holberton School**). But then, I decided to take it a step further and make it live for everyone to use. This project represents the culmination of my learning journey and showcases the skills I've developed throughout the course.\n\n## The Problem\n\nThe project aims to address the lack of online services that provide translation assistance for English speakers learning Moroccan Darija. This problem is particularly relevant in Morocco, where many foreigners are eager to learn the local language but struggle to find reliable resources to guide them.\n\n## Tech Stack\n\n- **Frontend**:\n\n  - `ReactJS` with **TypeScript**.\n  - `Tailwind CSS`\n  - `Shadcn/ui`\n\n- **Backend**:\n\n  - `Flask` (Python framework) for creating **APIs**.\n\n- **Database**:\n\n  - `MySQL` for managing structured data.\n  - `Firebase` to power the community forum.\n\n- **Third-Party Services**:\n  - `Algolia` for advanced search capabilities.\n  - `SendGrid` for handling email communications.\n\n## Installation\n\n### 1. Prerequisites\n\nEnsure you have the following tools installed on your machine:\n\n- `Python 3.12` and `pip` (Python package manager)\n- `Node.js` (preferably v20 or later) and `npm` (Node package manager)\n- `MySQL` for structured data storage\n- `Git` for version control\n\n### 2. Setting Up the Frontend (React with TypeScript)\n\n#### 1. Clone the repository:\n\n```bash\ngit clone https://github.com/EL-OUARDY/AtlasLingua.git\ncd AtlasLingua\n```\n\n#### 2. Install frontend dependencies:\n\n```bash\nnpm install\n```\n\n#### 3. Environment Variables:\n\nCopy `.env.example` to `.env` and replace placeholder values with actual values.\n\n### 3. Setting Up the Backend API (Flask)\n\n#### 1. Navigate to the backend folder\n\n```bash\ncd api\n```\n\n#### 2. Set up a virtual environment:\n\n```bash\npython -m venv venv\nsource venv/bin/activate\n```\n\n#### 3. Install backend dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n#### 4. Environment Variables:\n\nCopy `.env.example` to `.env` and replace placeholder values with actual values.\n\n#### 5. Setup database:\n\nCreate a MySQL database, configure the connection in the `.env` file, and then run the migration.\n\n```bash\nflask db init\nflask db migrate\nflask db upgrade\n```\n\n### 4. Running the Application\n\n#### 1. Start the backend API (Flask):\n\n```bash\npython run.py\n```\n\nThis will start the Flask server at http://localhost:5000.\n\n#### 2. Start the frontend (React):\n\n```bash\ncd ..\nnpm run dev\n```\n\nThis will start the frontend development server at http://localhost:3000.\n\n#### 3. Access the Application:\n\nVisit http://localhost:3000 in your browser to see the frontend.\n\n## Contact\n\n**Ouadia EL-Ouardy** \\\n**Email:** ouadia@elouardy.com \\\n**Website:** https://elouardy.com \\\n**Twitter:** https://twitter.com/_ELOUARDY\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fel-ouardy%2Fatlaslingua","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fel-ouardy%2Fatlaslingua","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fel-ouardy%2Fatlaslingua/lists"}