futurecoder

This is a free platform/course for people to teach themselves programming in Python, especially complete beginners at programming. It is carefully designed to reduce frustration and guide the user while still ensuring that they learn how to solve problems. The goal is for as many people as possible to learn programming.

You can try it out here: https://futurecoder.io/

Currently this is a work in progress. While most of the groundwork is in place, there is a lot to do to make this a complete course ready for users. All kinds of help are needed and greatly appreciated - please consider contributing or donating!

Alternatively, come have a chat on slack.

Features

For a fuller demonstration and explanation, watch this video.

Running locally

1. Fork the repository, and clone your fork.

2. If you want to run the system using Docker, which may be easier and will more closely resemble the production environment:

   1. Ensure you have docker and docker-compose installed.
   2. Create an empty file called .env in the repo root.
   3. Run docker-compose up.
   4. Skip the following two steps, everything should be running now.

3. In the backend folder:

   1. Ensure the python command points to Python 3.9.

   2. If you are on Linux/OSX, run ./setup.sh.

      If you are on Windows: (in a Powershell window with "Run as Administrator")

      1. Run Set-ExecutionPolicy -ExecutionPolicy Bypass to enable running scripts in Powershell.
      2. Run .\setup.ps1.

      This will:

      • Install poetry if needed.
      • Create a virtualenv and install Python dependencies.
      • Create a sqlite database, run migrations, and create a user.

   3. Activate the virtualenv with poetry shell.

   4. Run the backend development server with python manage.py runserver.

      • If you get ModuleNotFoundError: No module named 'resource' then set the environment variable SET_LIMITS to 0.

4. In the frontend folder:

   1. Ensure you have version 14.15.4 (lts/fermium) of node and version 7.5.2 of npm.

      If you are on Windows: (in a Powershell window with "Run as Administrator")

      • Run npm install --global windows-build-tools.

   2. Run npm ci to download dependencies.

   3. Run npm start to start the frontend development server.

5. Go to http://localhost:3000/accounts/login/ and login with the email "[email protected]" and the password "admin".

6. You should be redirected to http://localhost:3000/toc/ and see the Table of Contents.

To learn more about the system, see the contributing guide.

Controls

To explore the course more freely:

1. Click the hamburger menu icon in the top left.
2. Click Settings.
3. Turn Developer mode on.
4. This should give you two red buttons floating at the bottom of the screen. They change the currently active step, so you can move forward without having to complete exercises or backwards to test a step again.