mozilla / ai-guide

Mozilla AI Guide
Mozilla Public License 2.0
31 stars 27 forks source link

Mozilla AI Guide

Mozilla champions an open, accessible Internet where people have the reins. We welcome these recent amazing new AI breakthroughs.

However, with substantial corporate dollars being invested into AI R&D, it's unclear for both junior and senior engineers new to the scene to identify which paths are the ones that lead to sustainable open software. We've seen this story before.

Mozilla's efforts in AI are more than just technical - they're a call to action and unity across the currently fragmented open source AI Community.

Our AI Guide is a living, breathing resource, rooted in collaboration and community input for experts and newcomers alike, and we invite you to build alongside us.

We are currently welcoming contributions for:

Contribution Guide

Join our Discord →

PRs are open. Email ai-guide@mozilla.com if you need to reach us.

Installation

Getting Started

This project is a Static webpage with HTML, CSS and JS. We use Webpack to bundle everything to the dist/ folder. This project also uses Nunjucks Templates to enable the use of templating in this project. To convert Nunjucks templates to HTML, we use the html-bundler-webpack-plugin.

Installation

These instruction assume you have NodeJS installed.

To build AI Guide from source and run the site locally, you can clone the repo from GitHub:

npm install

Running npm install will install the NPM dependencies.

Make it run

Build the site and start the web server with:

npm start

That will run the webpack dev server.

View the site at http://localhost:8000/

Build static HTML files

npm run build

The Webpack will output all HTML files to a folder called dist.

AI Guide-specific instructions

The AI Guide is hosted in this repo, and uses a slightly different Markdown-flavored templating system, but the same npm steps above. It also uses Tailwind for CSS and doesn't use Protocol.

Content for the guide is generated from Markdown files in templates/ai/content using scripts in tools/. To generate fresh content: tools/build_ai_guide.sh

Note that pages in /pages/ai/content should always be generated using the script above.

To run the server: tools/build_ai_guide.sh npx tailwindcss -w npm run start

Go to /

Folder Hierarchy

All Nunjucks files are either located in the templates/ folder or the pages/ folder. The templates/ folder contains base templates that can be extended, or partials, which can be included in the files in the pages/ folder.

The pages/ folder contains the Nunjucks files which will be compiled to HTML and used on the MIECO site.

Deploy

Branches in the pull request queue will be given a demo server by Netlify. The bot will comment on the PR with the link.

The main branch is automatically deployed to the staging server https://mozilla-ai-guide.netlify.app/

To deploy to production push the main branch to the production branch.

git push origin main:prod