diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..88311ee --- /dev/null +++ b/.editorconfig @@ -0,0 +1,24 @@ +# EditorConfig: https://editorconfig.org +# These settings are honored by most editors and IDEs. + +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true +indent_style = space +indent_size = 2 + +[*.md] +trim_trailing_whitespace = false + +[*.{yml,yaml}] +indent_size = 2 + +[*.{json,jsonc}] +indent_size = 2 + +[Makefile] +indent_style = tab diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index dd84ea7..10a1b56 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -1,8 +1,8 @@ --- name: Bug report about: Create a report to help us improve -title: '' -labels: '' +title: '[Bug] ' +labels: 'bug' assignees: '' --- diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..5018628 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,11 @@ +blank_issues_enabled: false +contact_links: + - name: ๐Ÿ’ฌ Questions & Discussions + url: https://github.com/marvelefe/machinelearning101/discussions + about: Ask questions, share ideas, or get help with using Machine Learning 101. + - name: ๐Ÿ” Report a Security Vulnerability + url: https://github.com/marvelefe/machinelearning101/security/policy + about: Please report security issues privately โ€” do not open a public issue. + - name: ๐Ÿ“š Documentation + url: https://github.com/marvelefe/machinelearning101/blob/main/CONTRIBUTING.md + about: Read the contributing guide before opening a pull request. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md index bbcbbe7..29e680a 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -1,8 +1,8 @@ --- name: Feature request about: Suggest an idea for this project -title: '' -labels: '' +title: '[Feature] ' +labels: 'enhancement' assignees: '' --- diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..51e9181 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,46 @@ + + +## Description + + + +## Related Issue + + +Closes # + +## Type of Change + +- [ ] ๐Ÿ› Bug fix (non-breaking change that fixes an issue) +- [ ] โœจ New feature (non-breaking change that adds functionality) +- [ ] ๐Ÿ’ฅ Breaking change (fix or feature that changes existing behavior) +- [ ] ๐Ÿ“š Documentation update +- [ ] ๐ŸŽจ Design / UX / accessibility improvement +- [ ] โšก Performance improvement +- [ ] ๐Ÿงช Tests +- [ ] ๐Ÿ”ง Chore / refactor / tooling + +## How Has This Been Tested? + + + +- [ ] `npm run test` passes +- [ ] `npm run type-check` passes +- [ ] `npm run build` succeeds + +## Screenshots / Recordings + + + +## Checklist + +- [ ] My change is focused and does one thing +- [ ] I have added/updated tests for new or changed logic +- [ ] I have updated relevant documentation +- [ ] My commits follow [Conventional Commits](https://www.conventionalcommits.org/) +- [ ] My branch is up to date with `main` +- [ ] UI changes are responsive and keyboard accessible +- [ ] I have read the [Contributing Guide](../CONTRIBUTING.md) and agree to the [Code of Conduct](../CODE_OF_CONDUCT.md) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..2e83f29 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,78 @@ +name: CI + +on: + push: + branches: [main] + pull_request: + branches: [main] + +# Cancel superseded runs on the same ref to save CI minutes. +concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + +permissions: + contents: read + +jobs: + quality: + name: Type-check & test + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v7 + + - name: Setup Node + uses: actions/setup-node@v7 + with: + node-version-file: .nvmrc + cache: npm + + - name: Install dependencies + run: npm ci + + - name: Type-check + run: npm run type-check + + - name: Unit tests + run: npm run test + + build: + name: Build + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v7 + + - name: Setup Node + uses: actions/setup-node@v7 + with: + node-version-file: .nvmrc + cache: npm + + - name: Install dependencies + run: npm ci + + - name: Build + run: npm run build + + # NOTE: The Cloudflare Worker in worker/ is a separate sub-project with its own + # dependencies, tsconfig and tests. It is intentionally NOT part of this + # workflow yet because its test suite currently has pre-existing failures and + # type errors (see the tracking issue). Once those are resolved, add a job here: + # + # worker: + # runs-on: ubuntu-latest + # defaults: + # run: + # working-directory: worker + # steps: + # - uses: actions/checkout@v7 + # - uses: actions/setup-node@v7 + # with: + # node-version-file: .nvmrc + # cache: npm + # cache-dependency-path: worker/package-lock.json + # - run: npm ci + # - run: npm run type-check + # - run: npm run test diff --git a/.nvmrc b/.nvmrc new file mode 100644 index 0000000..2bd5a0a --- /dev/null +++ b/.nvmrc @@ -0,0 +1 @@ +22 diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..55dab09 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,129 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, caste, color, religion, or sexual +identity and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +- Demonstrating empathy and kindness toward other people +- Being respectful of differing opinions, viewpoints, and experiences +- Giving and gracefully accepting constructive feedback +- Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +- Focusing on what is best not just for us as individuals, but for the overall + community + +Examples of unacceptable behavior include: + +- The use of sexualized language or imagery, and sexual attention or advances of + any kind +- Trolling, insulting or derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or email address, + without their explicit permission +- Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +Community leaders have the right and responsibility to remove, edit, or reject +comments, commits, code, wiki edits, issues, and other contributions that are +not aligned to this Code of Conduct, and will communicate reasons for moderation +decisions when appropriate. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. +Examples of representing our community include using an official email address, +posting via an official social media account, or acting as an appointed +representative at an online or offline event. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the community leaders responsible for enforcement at +**marvelcamoarmy@gmail.com**. + +All complaints will be reviewed and investigated promptly and fairly. + +All community leaders are obligated to respect the privacy and security of the +reporter of any incident. + +## Enforcement Guidelines + +Community leaders will follow these Community Impact Guidelines in determining +the consequences for any action they deem in violation of this Code of Conduct: + +### 1. Correction + +**Community Impact**: Use of inappropriate language or other behavior deemed +unprofessional or unwelcome in the community. + +**Consequence**: A private, written warning from community leaders, providing +clarity around the nature of the violation and an explanation of why the +behavior was inappropriate. A public apology may be requested. + +### 2. Warning + +**Community Impact**: A violation through a single incident or series of +actions. + +**Consequence**: A warning with consequences for continued behavior. No +interaction with the people involved, including unsolicited interaction with +those enforcing the Code of Conduct, for a specified period of time. This +includes avoiding interactions in community spaces as well as external channels +like social media. Violating these terms may lead to a temporary or permanent +ban. + +### 3. Temporary Ban + +**Community Impact**: A serious violation of community standards, including +sustained inappropriate behavior. + +**Consequence**: A temporary ban from any sort of interaction or public +communication with the community for a specified period of time. No public or +private interaction with the people involved, including unsolicited interaction +with those enforcing the Code of Conduct, is allowed during this period. +Violating these terms may lead to a permanent ban. + +### 4. Permanent Ban + +**Community Impact**: Demonstrating a pattern of violation of community +standards, including sustained inappropriate behavior, harassment of an +individual, or aggression toward or disparagement of classes of individuals. + +**Consequence**: A permanent ban from any sort of public interaction within the +community. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], +version 2.1, available at +https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. + +Community Impact Guidelines were inspired by +[Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity). + +[homepage]: https://www.contributor-covenant.org + +For answers to common questions about this code of conduct, see the FAQ at +https://www.contributor-covenant.org/faq. Translations are available at +https://www.contributor-covenant.org/translations. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..497a443 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,216 @@ +# Contributing to Machine Learning 101 + +First off, thank you for considering a contribution! ๐ŸŽ‰ This project exists to +make machine learning approachable for everyone, and contributions of all kinds โ€” +code, content, docs, design, and bug reports โ€” are welcome and appreciated. + +By participating, you agree to abide by our +[Code of Conduct](CODE_OF_CONDUCT.md). + +- ๐ŸŒ Live site: **https://machinelearning101.com** +- ๐Ÿ› [Report a bug](https://github.com/marvelefe/machinelearning101/issues/new?template=bug_report.md) +- ๐Ÿ’ก [Request a feature](https://github.com/marvelefe/machinelearning101/issues/new?template=feature_request.md) +- ๐Ÿ™‹ [Good first issues](https://github.com/marvelefe/machinelearning101/labels/good%20first%20issue) +- ๐Ÿค [Help wanted](https://github.com/marvelefe/machinelearning101/labels/help%20wanted) + +--- + +## Ways to Contribute + +You don't need to be an ML expert or a seasoned developer. Some of the most +valuable contributions are: + +| Type | Examples | +| ---- | -------- | +| ๐Ÿ› **Bug fixes** | Broken visualizations, wrong math, mobile layout issues | +| โœจ **New modules** | Add an algorithm, dataset, or interactive demo | +| ๐Ÿ“š **Documentation** | Fix typos, clarify explanations, improve the guides in `docs/` | +| ๐ŸŽจ **Design & UX** | Accessibility, responsive layout, clearer controls | +| โšก **Performance** | Bundle size, rendering, Web Worker offloading | +| ๐Ÿงช **Tests** | Increase coverage in `tests/` | +| ๐ŸŒ **Localization** | Help translate the learning content | + +Not sure where to start? Browse issues labeled +[`good first issue`](https://github.com/marvelefe/machinelearning101/labels/good%20first%20issue) +or open a [discussion/question](https://github.com/marvelefe/machinelearning101/issues/new) +and we'll help you find something. + +--- + +## Getting Started + +### Prerequisites + +- **Node.js** 22 or higher (see [`.nvmrc`](.nvmrc)) โ€” we recommend + [nvm](https://github.com/nvm-sh/nvm): `nvm use` +- **npm** 10 or higher +- **Git** +- Basic familiarity with Vue 3, TypeScript, and machine learning concepts is + helpful but not required for docs/design work. + +### Set Up Your Environment + +1. **Fork** the repository on GitHub (use the **Fork** button in the top-right). + +2. **Clone your fork** and enter the directory: + + ```bash + git clone https://github.com/YOUR_USERNAME/machinelearning101.git + cd machinelearning101 + ``` + +3. **Add the upstream remote** so you can stay in sync: + + ```bash + git remote add upstream https://github.com/marvelefe/machinelearning101.git + ``` + +4. **Install dependencies**: + + ```bash + npm install + ``` + +5. **Start the dev server**: + + ```bash + npm run dev + ``` + +6. **Verify** by opening `http://localhost:3000`. + +--- + +## Development Workflow + +### 1. Create a Branch + +Always branch off an up-to-date `main`: + +```bash +git checkout main +git pull upstream main +git checkout -b feat/your-feature-name +# or +git checkout -b fix/short-bug-description +# or +git checkout -b docs/what-you-are-documenting +``` + +Branch prefix convention: `feat/`, `fix/`, `docs/`, `chore/`, `refactor/`. + +### 2. Make Your Changes + +Please follow the project's coding standards (see [`AGENTS.md`](AGENTS.md)): + +- **TypeScript** everywhere; no implicit `any`, and type your public APIs. +- **Vue 3 Composition API** with ` + + diff --git a/composables/useLazyAlgorithm.ts b/composables/useLazyAlgorithm.ts index 846b696..e27c112 100644 --- a/composables/useLazyAlgorithm.ts +++ b/composables/useLazyAlgorithm.ts @@ -7,10 +7,7 @@ * Requirements: 14.4, 14.8 */ -import type { Algorithm } from '~/types/algorithm'; - -type AlgorithmConstructor = new (...args: any[]) => T; - +type AlgorithmConstructor = new (...args: any[]) => T; /** * Lazy load an algorithm by domain and name */ @@ -86,7 +83,7 @@ export function useLazyAlgorithm() { switch (name) { case 'GradientDescentOptimizer': { const module = await import('~/algorithms/optimization/GradientDescentOptimizer'); - return module.GradientDescentOptimizer; + return (module as unknown as Record).GradientDescentOptimizer!; } case 'GradientDescentVisualization': { const module = await import('~/algorithms/optimization/GradientDescentVisualization'); @@ -94,7 +91,7 @@ export function useLazyAlgorithm() { } case 'LossLandscape': { const module = await import('~/algorithms/optimization/LossLandscape'); - return module.LossLandscape; + return (module as unknown as Record).LossLandscape!; } default: throw new Error(`Unknown optimization algorithm: ${name}`); diff --git a/composables/useModuleContent.ts b/composables/useModuleContent.ts index fde900f..eab544f 100644 --- a/composables/useModuleContent.ts +++ b/composables/useModuleContent.ts @@ -7,7 +7,7 @@ export const useModuleContent = async (domain: string, moduleId: string) => { const { data: content } = await useAsyncData( `${domain}-${moduleId}-content`, - () => queryContent(`modules/${domain}/${moduleId}/content`).findOne() + () => queryCollection('content').path(`/modules/${domain}/${moduleId}/content`).first() ); return { diff --git a/composables/useModules.ts b/composables/useModules.ts index b96c5cb..046d933 100644 --- a/composables/useModules.ts +++ b/composables/useModules.ts @@ -215,7 +215,7 @@ export function useModules() { const results = await Promise.all(configPromises); // Filter out null results - return results.filter((module): module is ModuleMetadata => module !== null); + return results.filter((module): module is NonNullable => module !== null); }; /** diff --git a/composables/useSEO.ts b/composables/useSEO.ts index 41069a4..986fefc 100644 --- a/composables/useSEO.ts +++ b/composables/useSEO.ts @@ -8,7 +8,7 @@ */ import { useHead, useSeoMeta } from '#app' -import type { UseSeoMetaInput } from '@unhead/schema' +import type { UseSeoMetaInput } from '@unhead/vue' export interface SEOConfig { title: string @@ -91,7 +91,9 @@ export function useSEO(config: SEOConfig) { // Robots ...(config.noindex && { robots: 'noindex, nofollow' }), - } as UseSeoMetaInput) + // `config.author` is a single string while unhead types `articleAuthor` as + // a list; keep the runtime value unchanged. + } as unknown as UseSeoMetaInput) // Set canonical URL and other head elements useHead({ diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 4bf4284..4c389a4 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -1,129 +1,10 @@ -# Contributing to ML Learning Platform +# Contributing -Thank you for your interest in contributing! This document provides guidelines and instructions for contributing to the project. +The canonical contribution guide for this project lives at the repository root: -## Getting Started +## ๐Ÿ‘‰ [CONTRIBUTING.md](../CONTRIBUTING.md) -### Prerequisites +It covers setup, development workflow, coding standards, testing, commit +conventions, and how to add a new learning module. -- Node.js 18 or higher -- npm or yarn -- Git -- Basic knowledge of Vue 3, TypeScript, and machine learning concepts - -### Setting Up Your Development Environment - -1. **Fork the repository** on GitHub - -2. **Clone your fork**: -```bash -git clone https://github.com/YOUR_USERNAME/ml-learning-platform.git -cd ml-learning-platform -``` - -3. **Add upstream remote**: -```bash -git remote add upstream https://github.com/ORIGINAL_OWNER/ml-learning-platform.git -``` - -4. **Install dependencies**: -```bash -npm install -``` - -5. **Start development server**: -```bash -npm run dev -``` - -6. **Verify the setup** by visiting `http://localhost:3000` - -## How to Contribute - -### Types of Contributions - -We welcome various types of contributions including: -- ๐Ÿ› Bug Fixes -- โœจ New Features -- ๐Ÿ“š Documentation -- ๐ŸŽจ Design Improvements -- โšก Performance Optimizations - - -## Development Workflow - -### 1. Create a Branch - -Always create a new branch for your work: - -```bash -# Update your main branch -git checkout main -git pull upstream main - -# Create a feature branch -git checkout -b feature/your-feature-name -# or -git checkout -b fix/bug-description -``` - -### 2. Make Your Changes - -- Write clean, readable code -- Follow the project's coding standards -- Add comments for complex logic -- Include JSDoc comments for public APIs - -### 3. Test Your Changes - -```bash -# Run unit tests -npm run test - -# Build the project -npm run build - -# Preview the build -npm run preview -``` - -### 4. Commit Your Changes - -Follow [Conventional Commits](https://www.conventionalcommits.org/): - -```bash -git add . -git commit -m "feat: add k-nearest neighbors algorithm" -``` - -### 5. Push to Your Fork - -```bash -git push origin feature/your-feature-name -``` - -### 6. Create a Pull Request - -1. Go to your fork on GitHub -2. Click "New Pull Request" -3. Select your branch -4. Fill out the PR template -5. Submit the PR - -## Submitting Changes - -### Pull Request Checklist - -Before submitting a PR, ensure: - -- [ ] Code follows project style guidelines -- [ ] All tests pass (`npm run test`) -- [ ] Build succeeds (`npm run build`) -- [ ] No console errors or warnings -- [ ] Documentation is updated -- [ ] Commit messages follow conventions -- [ ] Branch is up to date with main -- [ ] PR description is clear and complete - - -Thank you for contributing to ML Learning Platform! ๐Ÿš€ +For everything else, see the [documentation index](../README.md#-documentation). diff --git a/docs/DIRECTORY_LISTINGS.md b/docs/DIRECTORY_LISTINGS.md new file mode 100644 index 0000000..ca470c3 --- /dev/null +++ b/docs/DIRECTORY_LISTINGS.md @@ -0,0 +1,366 @@ +# Directory & Awesome-List Submission Opportunities + +Research date: **2026-10-17** + +Project: **Machine Learning 101** โ€” ยท repo: +Type: free, open-source (MIT), browser-based **interactive** ML learning platform for beginners (Nuxt 4 / Vue 3 / TypeScript). + +This document lists curated GitHub directories ("awesome" lists, learning-resource indexes, ecosystem showcases) +where the project can legitimately be added via a pull request. Every repo below was verified live with the GitHub +API (star count, last push, merge activity) and its `README.md` / `CONTRIBUTING.md` were read to confirm the exact +insertion point and the required entry format. + +> **Key strategic note.** Most *library/tool* awesome-lists gate on GitHub stars for the **project being submitted** +> (e.g. 50+, 1,000+). Machine Learning 101 is a **learning resource / website**, not a library, so the realistic wins +> are lists that index *educational resources and websites* โ€” those have no star threshold. Those are ranked first. +> +> **Pre-req:** the repo reports no LICENSE to GitHub's licensee detector even though a valid `LICENSE` (MIT) file +> exists at the root. Before submitting to lists that link sources, double-check that GitHub shows the MIT badge +> (add the SPDX line only if needed). No candidate below requires the *submitted site* to carry an awesome badge. + +--- + +## Summary table + +| # | Repo | Stars | Active? | What to add / where | Confidence | +|---|------|-------|---------|---------------------|------------| +| 1 | [academic/awesome-datascience](#1-academicawesome-datascience) | ~30.2k | **Yes** โ€” merges daily | `README.md` โ†’ `## Training Resources` โ†’ `### Tutorials` (append) | **High** | +| 2 | [nuxt/awesome](#2-nuxtawesome) | ~5.5k | **Yes** โ€” last merge 2026-10-10 | `README.md` โ†’ `### Projects Using Nuxt` (append) | **High** | +| 3 | [hamid-moghadam/awesome-interactive-learning](#3-hamid-moghadamawesome-interactive-learning) | ~10 | **Yes** โ€” merges 2026-10-12/16 | `README.md` โ†’ new `## Machine Learning & AI` (or `## Other Great Resources`) | **High** (low reach) | +| 4 | [vuejs/awesome-vue](#4-vuejsawesome-vue) | ~73.5k | **Yes** โ€” merges 2026-10-01 | `README.md` โ†’ `## Projects Using Vue.js` โ†’ `### Apps/Websites` (append) | **Medium-High** | +| 5 | [gs00s/awesome-vue-3](#5-gs00sawesome-vue-3) | ~1.6k | Yes โ€” last merge 2026-08-01 | `README.md` โ†’ `## Courses` (append) | **Medium-High** | +| 6 | [TirendazAcademy/Awesome-Data-Science-Resources](#6-tirendazacademyawesome-data-science-resources) | ~121 | Yes โ€” pushed 2026-08-17 | `README.md` โ†’ `# ๐Ÿš€ MACHINE LEARNING` โ†’ `### Courses` | **Medium-High** | +| 7 | [josephmisiti/awesome-machine-learning](#7-josephmisitiawesome-machine-learning) | ~74.6k | Yes โ€” but PRs restricted | `courses.md` โ†’ `## Machine-Learning / Data Mining` | Medium | +| 8 | [ChristosChristofidis/awesome-deep-learning](#8-christoschristofidisawesome-deep-learning) | ~29k | Semi โ€” last merge 2025-05 | `README.md` โ†’ `### Websites` (append) | Medium | +| 9 | [howie6879/mlhub123](#9-howie6879mlhub123) | ~1.1k | **Yes** โ€” pushed 2026-10-16 | `README.md` โ†’ `## ่ต„ๆบ` โ†’ `### ่ต„ๆบๆ”ถ้›†` | Medium (ไธญๆ–‡) | +| 10 | [guillaume-chevalier/Awesome-Deep-Learning-Resources](#10-guillaume-chevalierawesome-deep-learning-resources) | ~1.8k | Low โ€” last push 2024-01 | `README.md` โ†’ `## Online Classes` (append) | Medium-Low | +| 11 | [ujjwalkarn/Machine-Learning-Tutorials](#11-ujjwalkarnmachine-learning-tutorials) | ~18.3k | Low โ€” last push 2024-06 | `README.md` โ†’ `## Introduction` (append) | Medium-Low | +| 12 | [owainlewis/awesome-artificial-intelligence](#12-owainlewisawesome-artificial-intelligence) | ~16.7k | Yes โ€” last merge 2026-08 | `README.md` โ†’ `## Learn` โ†’ `### Courses` | Medium-Low (selective) | +| 13 | [allmachinelearning/MachineLearning](#13-allmachinelearningmachinelearning) | ~3.9k | Low โ€” last push 2024-04 | `README.md` โ†’ `## ่ฏพ็จ‹ไธŽ่ฎฒๅบง` โ†’ `### ๆœบๅ™จๅญฆไน ` | Low (ไธญๆ–‡, stale) | + +**Clearly NO (do not submit):** see [Not recommended / rejected](#not-recommended--rejected). + +--- + +## 1. academic/awesome-datascience + +- **URL:** ยท **Stars:** ~30,198 ยท **Default branch:** `live` +- **Activity:** **Very active** โ€” merged PRs #724/#725/#727 all on 2026-10-16. Actively maintained. +- **What it indexes:** A broad "awesome Data Science" list of tools, courses, tutorials, books, datasets, communities. + Explicitly beginner-oriented ("How do you learn data science? By doing data science"). +- **Fit:** **Excellent.** The `### Tutorials` subsection already contains interactive/visual ML learning resources + (e.g. *StepByStepML โ€” interactive calculator that visualizes the step-by-step math behind ML algorithms*). + A free browser-based interactive platform fits the section's intent squarely. +- **Exact place:** `README.md` โ†’ `## Training Resources` โ†’ `### Tutorials`. Append at the **end** of the section + (after `Train LLM From Scratch`). The section is not alphabetized; append-only is consistent with recent edits. +- **Contribution requirements (`CONTRIBUTING.md`):** consistent bullet format `- [Name](URL) - Short description.`; + descriptions one sentence, title case, **no marketing language/superlatives**; prefer `https://`, no URL shorteners; + add near similar items; complete the PR template (tip model, license type, **your relationship to the project**); + link checks must pass. Code of Conduct applies. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - Free browser-based platform that teaches core machine learning algorithms through hands-on, interactive visualizations with no setup. + ``` +- **Confidence:** **High.** + +--- + +## 2. nuxt/awesome + +- **URL:** (canonical; `nuxt-community/awesome-nuxt` redirects here) ยท **Stars:** ~5,537 +- **Activity:** Active โ€” `chore(showcase): remove faker.js` merged 2026-10-10; showcase entries are hand-curated. +- **What it indexes:** Everything Nuxt โ€” official resources, modules, examples, articles, books, open-source projects, + and a large curated **"Projects Using Nuxt"** website showcase. +- **Fit:** **Excellent.** ML101 is built with Nuxt 4. The showcase section lists production/education websites + (Khan-style platforms, universities, products) with a one-line description. +- **Exact place:** `README.md` โ†’ `### Projects Using Nuxt`. Append to the **bottom** of the list (the section is a plain + bullet list; new sites are added at the end). +- **Contribution requirements (`contributing.md`):** submission **must be Nuxt related**; search for duplicates first; + **one suggestion per PR**; format exactly `[Title](link) - Description.`; additions go to the **bottom of the + relevant category**; descriptions start with a capital and end with a period, no leading "A"/"An"; no trailing + whitespace; PR title should state the package/site and why it belongs. New categories in a separate PR. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - Free, interactive, browser-based machine learning learning platform for beginners. + ``` +- **Confidence:** **High.** + +--- + +## 3. hamid-moghadam/awesome-interactive-learning + +- **URL:** ยท **Stars:** ~10 +- **Activity:** **Very active for its age** โ€” new repo, PRs #1 (2026-10-12) and #2 (2026-10-16) already merged. + CC0-licensed, clearly welcoming contributions. +- **What it indexes:** *Only* interactive learning platforms, visualizations, labs and hands-on courses + (Learn Git Branching, Seeing Theory, Frontend Mentor, AlgoViz, โ€ฆ). This is the most on-topic list found. +- **Fit:** **Perfect conceptually** โ€” but reach is tiny (single-digit stars). Low risk, low reward. +- **Exact place:** `README.md`. Either append to `## Other Great Resources`, **or** (better) open a small companion PR + adding a new `## Machine Learning & AI` section and its entry in `## Contents`. +- **Contribution requirements (`CONTRIBUTING.md`):** resource **must be interactive** (not static article/video); + PR body uses format `- [Name](https://example.com/) โ€“ Short description (1 sentence)` (note the en dash `โ€“`). +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) โ€“ Free browser-based platform for learning ML algorithms by adjusting parameters and watching training run live. + ``` +- **Confidence:** **High** (that it is accepted); reach is **low**. + +--- + +## 4. vuejs/awesome-vue + +- **URL:** ยท **Stars:** ~73,516 +- **Activity:** **Very active** โ€” multiple merges on 2026-10-01 (#4559, #4556, #4554). +- **What it indexes:** The flagship Vue.js list: projects, components, ecosystem, and a "Projects Using Vue.js" showcase + split into `### Open Source`, `### Commercial Products`, `### Apps/Websites`, `### Interactive Experiences`. +- **Fit:** **Good.** Submit to the **website** showcase (not "Open Source", which requires the linked repo to be the + entry and is stricter). Nuxt/Vue is used intensively and is detectable with vue-devtools, which satisfies the rule. +- **Exact place:** `README.md` โ†’ `## Projects Using Vue.js` โ†’ `### Apps/Websites`. **Append to the end** (order is + first-come-first-served). +- **Contribution requirements (`.github/contributing.md` + `pull_request_template.md`):** put items in the right + category; **always add to the end of the list**; site must load without errors/SSL issues and be reasonably fast; + must use Vue intensively (detectable via vue-devtools, else attach a screenshot in the PR); must be **original and + not too simple** (blogs/simple landing pages rejected); not a commercial product. Fill out the PR template checkboxes. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - Interactive, browser-based machine learning learning platform for beginners built with Vue and Nuxt. + ``` +- **Confidence:** **Medium-High.** + +--- + +## 5. gs00s/awesome-vue-3 + +- **URL:** ยท **Stars:** ~1,646 +- **Activity:** Yes โ€” merges on 2026-08-01 (#150, #149, #147). +- **What it indexes:** Curated list of *Vue 3* resources, articles, packages, examples, tools, videos, books, courses. +- **Fit:** Good โ€” a real Vue 3 + Nuxt project can be listed as a course/resource. The `## Courses` section holds + learning platforms (Vue School, Vue Mastery, Frontend Masters). +- **Exact place:** `README.md` โ†’ `## Courses`. Append at the bottom. (Alternative: `## Examples` only if you point to + the source repo; Courses is the better semantic fit for a learning platform.) +- **Contribution requirements (`CONTRIBUTING.md`):** state the **intent/problem** in the PR; quality bar (no spelling + mistakes, reads well); must move the repo toward its vision; respect the Contributor Covenant. No strict formatting + mandate โ€” mirror the existing bullet style. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - Interactive Vue 3 and Nuxt learning platform that teaches machine learning through in-browser visualizations. + ``` +- **Confidence:** **Medium-High.** + +--- + +## 6. TirendazAcademy/Awesome-Data-Science-Resources + +- **URL:** ยท **Stars:** ~121 +- **Activity:** Pushed 2026-08-17. Low-volume but current; no CONTRIBUTING.md (follow existing style). +- **What it indexes:** A tidy, sectioned data-science resource list: Data Science, **Machine Learning**, ML Engineering, + Deep Learning, Generative AI, NLP, Data Engineering, SQL โ€” each with `Free Books`, `Courses`, `Tools`, `Repos`, `Projects`. +- **Fit:** **Good.** The `# ๐Ÿš€ MACHINE LEARNING` โ†’ `### Courses` block already lists third-party learning resources + (Coursera, TutorialSearch, โ€ฆ). An interactive free platform fits. +- **Exact place:** `README.md` โ†’ `# ๐Ÿš€ MACHINE LEARNING` โ†’ `### Courses`. Append at the bottom of that list. +- **Contribution requirements:** No `CONTRIBUTING.md`; match the surrounding bullets (`- [Name](url) - description`). + Keep it factual and free. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - Free interactive browser-based platform to learn machine learning algorithms by experimenting with them. + ``` +- **Confidence:** **Medium-High.** + +--- + +## 7. josephmisiti/awesome-machine-learning + +- **URL:** ยท **Stars:** ~74,597 ยท **Default branch:** `master` +- **Activity:** Repo pushed 2026-10-13, but the README carries an explicit notice: *"As of April 2026, too many PRs are + being generated by LLMsโ€ฆ If you want to contributeโ€ฆ email me โ€ฆ with a link to your PR and I'll merge it."* +- **What it indexes:** The main list is **frameworks, libraries and software by language**. Learning material lives in + separate files: `books.md`, `courses.md`, `blogs.md`, `events.md`, `meetups.md`. +- **Fit:** The interactive platform belongs **only** in `courses.md` ("free or paid online courses on machine learningโ€ฆ"). + `courses.md` already lists visual/interactive items (MLU-Explain, fast.ai) and even platform-style entries. +- **Exact place:** `courses.md` โ†’ `## Machine-Learning / Data Mining`, near the top (recent "System Designer" + platform entries are at the top). +- **Contribution requirements:** No CONTRIBUTING.md, but the README notice **requires emailing the maintainer** to prove + you are human, with a link to the PR. Entries use `* [Name](url) - description - free`. Expect friction. +- **Proposed entry:** + ```markdown + * [Machine Learning 101](https://machinelearning101.com) - Interactive, browser-based platform for learning core ML algorithms through hands-on visualizations - free + ``` +- **Confidence:** **Medium** (great reach; extra manual email gate + it is primarily a software list). + +--- + +## 8. ChristosChristofidis/awesome-deep-learning + +- **URL:** ยท **Stars:** ~29,057 +- **Activity:** Semi-active โ€” last merge 2025-05-26 (#252). Occasional merges; the list is dated but still widely used. +- **What it indexes:** Deep-learning books, courses, videos, papers, tutorials, **websites**, datasets, tools, + communities. +- **Fit:** Good โ€” the `### Websites` section is literally external sites (deeplearning.net, Stanford pagesโ€ฆ); ML101 is a + website. `### Tutorials` is a reasonable alternative. +- **Exact place:** `README.md` โ†’ `### Websites`. Entries are a **numbered list** (`1. [name](url)`); append as the next + number. +- **Contribution requirements:** `### Contributing` says simply to send a pull request (the link points to a fork's PR + page). No linting, no format spec beyond the numbered list. CC0. +- **Proposed entry:** + ```markdown + 11. [Machine Learning 101](https://machinelearning101.com) + ``` +- **Confidence:** **Medium** (slow maintainer; dated README aesthetic). + +--- + +## 9. howie6879/mlhub123 + +- **URL:** ยท **Stars:** ~1,147 +- **Activity:** **Very active** โ€” pushed 2026-10-16. +- **What it indexes:** A Chinese-language roundup of ML/DL **websites & resources** (news, tools, communities, blogs, + courses, open-source books, projects). +- **Fit:** Good if you can supply a Chinese description; it indexes learning websites directly. +- **Exact place:** `README.md` โ†’ `## ่ต„ๆบ` โ†’ `### ่ต„ๆบๆ”ถ้›†` (resource collection) or `### ่ฏพ็จ‹ๅญฆไน ` (courses). +- **Contribution requirements:** No `CONTRIBUTING.md`; entries are Chinese bullet lines; the site itself is bilingual, + so a Chinese one-liner is expected. `https://machinelearning101.com` is fine as the URL. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - ๅ…่ดน็š„ๆต่งˆๅ™จ็ซฏไบคไบ’ๅผๆœบๅ™จๅญฆไน ๅญฆไน ๅนณๅฐ๏ผŒ้€š่ฟ‡ๅฏ่ง†ๅŒ–ๅฎž้ชŒๅธฎๅŠฉๅˆๅญฆ่€…็†่งฃ็ฎ—ๆณ•ใ€‚ + ``` +- **Confidence:** **Medium** (language requirement; active maintainer). + +--- + +## 10. guillaume-chevalier/Awesome-Deep-Learning-Resources + +- **URL:** ยท **Stars:** ~1,821 +- **Activity:** Low โ€” last push 2024-01-18. Personal but fairly popular list. +- **What it indexes:** Trends, **Online Classes**, books, posts, practical resources, math theory, papers, videos, and a + `Misc. Hubs & Links` section. +- **Fit:** Medium โ€” the list is opinionated/personal; `## Online Classes` (which includes free courses and YouTube + series) is the best home. `## Misc. Hubs & Links` is a fallback. +- **Exact place:** `README.md` โ†’ `## Online Classes`, append; or `## Misc. Hubs & Links`. +- **Contribution requirements:** No CONTRIBUTING.md; match `- [Name](url) - description.` bullets. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - Free, browser-based interactive platform for building intuition about ML algorithms with zero setup. + ``` +- **Confidence:** **Medium-Low** (stale maintenance). + +--- + +## 11. ujjwalkarn/Machine-Learning-Tutorials + +- **URL:** ยท **Stars:** ~18,280 +- **Activity:** Low โ€” last push 2024-06-12. Large and well-known, but quiet. +- **What it indexes:** Beginner ML/DL tutorials, courses and articles, grouped by topic (`## Introduction`, + `## Other Tutorials`, per-algorithm sections). +- **Fit:** Medium โ€” `## Introduction` already lists beginner breakthroughs and "curated list" links; a free interactive + beginner platform fits there or in `## Other Tutorials`. +- **Exact place:** `README.md` โ†’ `## Introduction`, append; or `## Other Tutorials` (end of file). +- **Contribution requirements:** No CONTRIBUTING.md. Entries are plain `- [Name](url)` bullets. Large list, informal + review; CC0. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) + ``` +- **Confidence:** **Medium-Low** (maintainer inactivity; may not be reviewed). + +--- + +## 12. owainlewis/awesome-artificial-intelligence + +- **URL:** ยท **Stars:** ~16,680 +- **Activity:** Yes โ€” merges 2026-08-15. Now has automated validation (`scripts/validate_readme.py`) and a strict + curation policy (`CURATION.md`). +- **What it indexes:** An intentionally **selective** guide organised around three pillars: AI foundations, building AI + systems, agentic software engineering. Books, courses, papers. +- **Fit:** Medium-low. An interactive beginner ML platform *can* serve "AI foundations โ†’ high-quality courses and + tutorials", but the policy explicitly warns against promotion-driven personal projects and general product + directories. Submission must argue differentiation from the strongest existing entry. +- **Exact place:** `README.md` โ†’ `## Learn` โ†’ `### Courses`, appended. +- **Contribution requirements (`CONTRIBUTING.md` + `CURATION.md`):** read `CURATION.md`; must serve a pillar; provide + evidence (primary source, maintenance status, **your affiliation**); format exactly + `- [Resource name](https://example.com/): One factual sentence explaining its value to developers.`; run the three + validation commands locally; complete the PR template. Maintainers may decline entries that pass checks but fail the + scope/quality policy. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com): A free, browser-based course that teaches core machine learning algorithms through interactive, parameter-driven visualizations. + ``` +- **Confidence:** **Medium-Low** (deliberately selective list). + +--- + +## 13. allmachinelearning/MachineLearning + +- **URL:** ยท **Stars:** ~3,865 +- **Activity:** Low โ€” last push 2024-04-01. Chinese-language ML resource index. +- **What it indexes:** Prerequisites, notes, **courses & talks** (`## ่ฏพ็จ‹ไธŽ่ฎฒๅบง`) by ML/DL/RL, books, miscellaneous. +- **Fit:** Medium โ€” an interactive beginner platform fits the courses section, but the repo is stale and mostly Chinese. +- **Exact place:** `README.md` โ†’ `## ่ฏพ็จ‹ไธŽ่ฎฒๅบง` โ†’ `### ๆœบๅ™จๅญฆไน `. +- **Contribution requirements:** Has a `## ๅฆ‚ไฝ•ๅŠ ๅ…ฅ How to contribute` section; no strict format; Chinese context + preferred. +- **Proposed entry:** + ```markdown + - [Machine Learning 101](https://machinelearning101.com) - ๅ…่ดน็š„ไบคไบ’ๅผๆœบๅ™จๅญฆไน ๅญฆไน ๅนณๅฐ๏ผŒๅœจๆต่งˆๅ™จไธญๅŠจๆ‰‹ๅญฆไน ็ฎ—ๆณ•ใ€‚ + ``` +- **Confidence:** **Low** (stale + language barrier). + +--- + +## Not recommended / rejected + +These were checked and are **not viable** โ€” do not spend a PR here. + +| Repo | Reason | +|------|--------| +| [sindresorhus/awesome](https://github.com/sindresorhus/awesome) | README states **PRs are temporarily disabled**. It also indexes lists, not resources. | +| [sdmg15/Best-websites-a-programmer-should-visit](https://github.com/sdmg15/Best-websites-a-programmer-should-visit) | Repository is **archived**. | +| [Machine-Learning-Tokyo/Interactive_Tools](https://github.com/Machine-Learning-Tokyo/Interactive_Tools) | Topically ideal (interactive ML tools), but **last merged PR was 2020** โ€” effectively unmaintained. | +| [EbookFoundation/free-programming-books](https://github.com/EbookFoundation/free-programming-books) | Organised **by programming language** for books/courses; a standalone platform has no correct section. | +| [practical-tutorials/project-based-learning](https://github.com/practical-tutorials/project-based-learning) | Requires a **project-based tutorial where the reader builds an artifact**. ML101 is a platform, not a tutorial series; a validator + link checker enforces this. | +| [hal9ai/awesome-dataviz](https://github.com/hal9ai/awesome-dataviz) | Only accepts **data-visualization libraries** (open-source repos, 50+ stars). ML101 is not a dataviz library. | +| [lukasmasuch/best-of-ml-python](https://github.com/lukasmasuch/best-of-ml-python) / [krzjoa/awesome-python-data-science](https://github.com/krzjoa/awesome-python-data-science) | Python **software/libraries** only. | +| [steven2358/awesome-generative-ai](https://github.com/steven2358/awesome-generative-ai) | Main list requires **1,000+ followers**; ML101 would be pushed to `DISCOVERIES.md`. | +| [natnew/Awesome-Data-Science](https://github.com/natnew/Awesome-Data-Science) | Requires the submitted repo to be **30+ days old and have 60+ stars** โ€” not met. | +| [prakhar1989/awesome-courses](https://github.com/prakhar1989/awesome-courses) | **University courses** only; last push 2023. | +| [kmario23/deep-learning-drizzle](https://github.com/kmario23/deep-learning-drizzle) | Only accepts courses **with lecture videos**. | +| [dair-ai/ML-YouTube-Courses](https://github.com/dair-ai/ML-YouTube-Courses) | **YouTube-only**; last push 2024-01. | +| [yrgo/awesome-educational-games](https://github.com/yrgo/awesome-educational-games) | **Educational games** only. | +| [onmyway133/awesome-machine-learning](https://github.com/onmyway133/awesome-machine-learning) | Explicitly **CoreML/iOS** focused. | +| [TarrySingh/Artificial-Intelligence-Deep-Learning-Machine-Learning-Tutorials](https://github.com/TarrySingh/Artificial-Intelligence-Deep-Learning-Machine-Learning-Tutorials) | Hosts its **own** lessons; not a directory of external resources. | +| [mercer/awesome-educate](https://github.com/mercer/awesome-educate) / [brandonhimpfen/awesome-ml](https://github.com/brandonhimpfen) style micro-lists | **Dead/low activity** (<60โ˜…, last push 2022) โ€” not worth it. | + +--- + +## How to submit + +Submit **one PR per repo** (nearly every list requires this), appending to the bottom of the specified section. + +1. **Fork & branch.** Branch like `docs/add-machine-learning-101`. +2. **Make the minimal edit** exactly in the file/section named above, matching the surrounding bullet style. + Do not reorder or reword unrelated entries. +3. **Self-disclose authorship.** State in the PR body that you are the author/maintainer of Machine Learning 101 + (required by `academic/awesome-datascience` and `owainlewis/awesome-artificial-intelligence`; encouraged elsewhere). +4. **Use the project's canonical URL** `https://machinelearning101.com` (not the GitHub repo) unless the list + explicitly asks for the source repo. +5. **Follow each list's mechanical rules:** + - `academic/awesome-datascience`, `nuxt/awesome`, `vuejs/awesome-vue`: run the repo's link check / use their PR template. + - `practical-tutorials/*` and `owainlewis/*`: run their local validators (`python3 scripts/...`) before opening the PR. + - Watch for alphabetical-order requirements (most sections here are append-only; the dataviz list is not relevant). +6. **Order of attack (best ROI first):** + 1. `academic/awesome-datascience` (huge, active, perfect fit) + 2. `nuxt/awesome` (native Nuxt showcase) + 3. `vuejs/awesome-vue` (native Vue showcase) + 4. `TirendazAcademy/Awesome-Data-Science-Resources` and `gs00s/awesome-vue-3` (easy wins) + 5. `hamid-moghadam/awesome-interactive-learning` (trivial, on-topic) + 6. `josephmisiti/awesome-machine-learning` (`courses.md` + email the maintainer) and `ChristosChristofidis/awesome-deep-learning` + 7. Long shots: `owainlewis/...`, `howie6879/mlhub123`, `guillaume-chevalier/...`, `ujjwalkarn/...`, `allmachinelearning/...` +7. **Track progress** with the companion GitHub issue in this repo + (`Submit project to curated awesome-lists and learning directories`). + +### Suggested PR body (reusable) + +> **Add [Machine Learning 101](https://machinelearning101.com) to `
`** +> +> Machine Learning 101 is a free, open-source (MIT), browser-based interactive learning platform for machine learning +> beginners. It runs entirely in the browser with zero setup and lets learners adjust parameters and watch algorithms +> (regression, classification, clustering, gradient descent, PCA, t-SNE, neural nets) train and update in real time. +> Built with Nuxt 4 / Vue 3 / TypeScript. I am the project maintainer. diff --git a/error.vue b/error.vue index c0795a1..4fc5a20 100644 --- a/error.vue +++ b/error.vue @@ -60,6 +60,8 @@