{"id":26889757,"url":"https://github.com/0xteamcookie/learnability","last_synced_at":"2025-06-15T01:37:28.037Z","repository":{"id":285431054,"uuid":"948049529","full_name":"0xteamCookie/LearnAbility","owner":"0xteamCookie","description":"LearnAbility is a comprehensive learning platform designed to provide an accessible, personalized, and inclusive educational experience for all users—especially underserved communities and students with disabilities.","archived":false,"fork":false,"pushed_at":"2025-03-31T17:17:35.000Z","size":2151,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-31T18:30:07.658Z","etag":null,"topics":["cloud","dart","dyslexia","edtech","google","google-cloud","learnability","milvus","rag","typescript","vector-database","vertex-ai"],"latest_commit_sha":null,"homepage":"https://web-la.rkr.cx:8443","language":"Dart","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/0xteamCookie.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":"2025-03-13T17:00:45.000Z","updated_at":"2025-03-31T10:56:14.000Z","dependencies_parsed_at":"2025-03-31T18:30:31.955Z","dependency_job_id":"9811af9e-44cd-47ec-b371-7a03486b2cc9","html_url":"https://github.com/0xteamCookie/LearnAbility","commit_stats":null,"previous_names":["0xteamcookie/learnability"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xteamCookie%2FLearnAbility","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xteamCookie%2FLearnAbility/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xteamCookie%2FLearnAbility/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xteamCookie%2FLearnAbility/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xteamCookie","download_url":"https://codeload.github.com/0xteamCookie/LearnAbility/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246547387,"owners_count":20794970,"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":["cloud","dart","dyslexia","edtech","google","google-cloud","learnability","milvus","rag","typescript","vector-database","vertex-ai"],"created_at":"2025-03-31T21:56:21.696Z","updated_at":"2025-06-15T01:37:28.025Z","avatar_url":"https://github.com/0xteamCookie.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"![LearnAbility Banner](https://github.com/user-attachments/assets/97f0e1ca-e42a-46ec-a676-7f4500e8b718)\n\n# LearnAbility: Personalized \u0026 Accessible Learning 🚀\n\n[![Platforms](https://img.shields.io/badge/Platform-Android%20%7C%20iOS%20%7C%20Web%20%7C%20Desktop-blue?logo=flutter)](https://flutter.dev) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![GitHub stars](https://img.shields.io/github/stars/0xteamCookie/LearnAbility?style=social)](https://github.com/0xteamCookie/LearnAbility) [![GitHub forks](https://img.shields.io/github/forks/0xteamCookie/LearnAbility?style=social)](https://github.com/0xteamCookie/LearnAbility)\n\n**Important Backend Notice:**\n\u003e The backend code (API, database setup, AI service integration) resides in its own repository. Please refer to the [**LearnAbility Backend Repository**](https://github.com/0xteamCookie/LearnAbility-backend) for backend setup instructions and code. You will need to have the backend services running for the frontend application to function fully.\n---\n\n## ✨ Our Solution: LearnAbility\n\nMeet LearnAbility – your personalized learning co-pilot! 🧑‍✈️ We're transforming how students learn using AI to turn standard course materials (notes, PDFs, etc.) into tailored, interactive lessons.\n\n**Key Ideas:**\n*   🧠 **Personalized Paths:** Content adapts to individual learning styles and pace.\n*   ♿ **Accessibility Core:** Built with features for visual, auditory, and cognitive accessibility.\n*   📱 **Mobile First:** Delivered through a cross-platform Flutter application.\n\nWe aim to provide an equitable and engaging learning experience for every student.\n\n## 🌟 Core Features\n\n*   🤖 **AI Content Generation:** Automatically creates lessons, quizzes, and summaries from your uploaded materials (notes, PDFs, etc.).\n*   📈 **Adaptive Learning:** Intelligently adjusts content difficulty and provides personalized feedback based on your progress.\n*   ♿ **Accessibility Suite:** Includes high-contrast themes, adjustable text sizes, dyslexia-friendly fonts (like OpenDyslexic), text-to-speech output, and potential for voice navigation.\n*   🎮 **Interactive Learning:** Offers engaging lesson formats, dynamic quizzes, and visual progress tracking to keep you motivated.\n*   🔍 **Smart Search:** Leverages vector search (Milvus) to quickly find the most relevant information within your study materials.\n\n## ✨ App Showcase\n\n![App Showcase](https://github.com/user-attachments/assets/1b25feed-4714-4844-ac09-2a1c537ec550)\n\n---\n\n### 🚀 Live Demo\n\n🔗 [**Click here to try the app**](https://web-la.rkr.cx:8443/)  \n\n---\n\n### 🎥 Video Demo\n \n➡️ [**Watch on YouTube**](https://youtu.be/dGgB7XxqR2M)\n\n---\n\n## 🛠️ Technology Stack\n\n*   **Frontend:** Flutter, Dart 📱\n*   **Backend:** Node.js, Express.js, TypeScript ⚙️\n*   **Database:** PostgreSQL, Milvus (Vector DB) 💾\n*   **AI:** Google Vertex AI (Gemini API, RAG) 🧠\n*   **Validation:** Zod (Backend) ✅\n*   **Authentication:** JWT 🔑\n*   **Containerization:** Docker \u0026 Docker Compose (for Backend Services) 🐳\n\n## 🏗️ Architecture Overview\n\n* The application consists of a Flutter frontend communicating with the backend API built with Node.js and written in TypeScript. The backend handles business services logic, data storage, and AI interactions.\n* Prisma ORM for PostgreSQL, Milvus for vector search, and Google Vertex AI (Gemini) for AI tasks.\n\n```mermaid\nflowchart LR\n    User[User via Flutter App] --\u003e API[Backend Express API]\n    API --\u003e Auth[Auth Middleware]\n    Auth --\u003e Routes[API Routes]\n    Routes --\u003e Handlers[Request Handlers]\n    Handlers --\u003e Services[Business Logic Services]\n    Services --\u003e Gemini[Gemini AI Service]\n    Services --\u003e Milvus[Milvus Service]\n    Services --\u003e Prisma[Prisma ORM]\n    Prisma --\u003e DB[(PostgreSQL DB)]\n    Milvus --\u003e MilvusDB[(Milvus Vector DB)]\n    Gemini --\u003e VertexAI[Google Vertex AI]\n\n    style API fill:#f9f,stroke:#333,stroke-width:2px\n    style DB fill:#ccf,stroke:#333,stroke-width:2px\n    style MilvusDB fill:#cdf,stroke:#333,stroke-width:2px\n    style VertexAI fill:#fca,stroke:#333,stroke-width:2px\n```\n\n## 🌍 Our Commitment to Quality Education (UN SDG 4)\n\n*   **Learning for Everyone:** Not everyone learns the same way. LearnAbility adapts to *your* pace and style, making sure no one gets left behind. This is especially helpful for students who find standard methods challenging.\n*   **Breaking Down Barriers:** We've included features like dyslexia-friendly fonts (like OpenDyslexic), adjustable text sizes, and text-to-speech. It's about making sure the platform is usable and comfortable for learners with different needs.\n*   **Smarter Learning, Not Just More Studying:** Using AI, we turn your notes and materials into engaging lessons and quizzes. It's about understanding concepts better, not just memorizing facts. The adaptive feedback helps you focus where you need it most.\n*   **Learning Beyond the Classroom:** Education doesn't stop after school. LearnAbility lets you use your own materials, supporting continuous learning and skill development throughout life.\n\n## 🚀 Getting Started (Overview)\n\nThis repository contains the **Flutter Frontend** for LearnAbility. The backend service is maintained in a separate repository.\n\n**Important Backend Notice:**\n\u003e The backend code (API, database setup, AI service integration) resides in its own repository. Please refer to the [**LearnAbility Backend Repository**](https://github.com/0xteamCookie/LearnAbility-backend) for backend setup instructions and code. You will need to have the backend services running for the frontend application to function fully.\n\n**Frontend Setup:**\n\n1.  Ensure you have the [Flutter SDK](https://flutter.dev/) installed.\n2.  Clone this repository: `git clone https://github.com/0xteamCookie/LearnAbility.git`\n3.  Navigate to the project directory: `cd LearnAbility`\n4.  Install dependencies: `flutter pub get`\n5.  **Ensure the backend services are running** (see the [Backend Repository](https://github.com/0xteamCookie/LearnAbility-backend) for instructions).\n6.  Run the Flutter application: `flutter run` (select your target device/emulator).\n\n*(Prerequisites: Flutter, Dart, Git. See backend repository for its prerequisites like Node.js, Docker)*\n\n## 🔗 Project Repositories\n\n*   **Frontend (This Repository):** [https://github.com/0xteamCookie/LearnAbility](https://github.com/0xteamCookie/LearnAbility)\n*   **Backend Repository:** [https://github.com/0xteamCookie/LearnAbility-backend](https://github.com/0xteamCookie/LearnAbility-backend)\n\n## 🍪 Meet the Team: teamCookie()\n\n*   **[shaunakc11](https://github.com/shaunakc11)** - Full Stack Developer | AI Engineer\n*   **[0xPixelNinja](https://github.com/0xPixelNinja)** - Backend Developer\n*   **[Kathrina-dev](https://github.com/Kathrina-dev)** - Frontend and UI/UX Designer\n*   **[pranjal-kumar-0](https://github.com/pranjal-kumar-0)** - Frontend and UI/UX Designer\n\n## 📜 License\n\nLicensed under the **GNU General Public License v3.0**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xteamcookie%2Flearnability","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xteamcookie%2Flearnability","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xteamcookie%2Flearnability/lists"}