Need help with futurecoder?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

alexmojaki
363 Stars 26 Forks MIT License 663 Commits 39 Opened issues

Description

A platform for beginners to learn programming in Python

Services available

!
?

Need anything else?

Contributors list

# 7,201
Python
debuggi...
introsp...
sentry
473 commits
# 4,232
Python
communi...
HTML
Shell
59 commits
# 8,887
Shell
python-...
python-...
luajit
9 commits

logo

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.

The course is a fully interactive 'book' which requires the user to run code in the provided editor or shell to advance:

full

This requires a mixture of solving problems or simply typing and running provided code. In the latter case, the user is often kept engaged by being asked to predict the output in a simple multiple choice question: The code at each step is checked automatically. If needed, the student can get small hints to gradually guide them to the solution:

predict_output

hints

If they're still really stuck, they can reveal the solution bit by bit:

Or in some cases solve a Parsons problem instead, where they have to put a shuffled solution in the correct order:

solution

parsons

Tracebacks are more helpful than usual, with several enhancements:
  • Highlighting the exact operation that failed, not just the line, using executing
  • Tables of local variables and simple expressions evaluated by pure_eval
  • Suggestions for fixes provided by DidYouMean
  • Beginner friendly explanations provided by friendly-traceback (shown when hovering over the little i icon)
  • Showing multiline statements in full thanks to stack_data without showing unnecessary extra lines
Common mistakes can be caught and pointed out to the student. This includes specific checks in some steps as well as linting tailored for beginners.

traceback

executing

Several debuggers are provided, including snoop...

...birdseye...

snoop

birdseye

...and Python Tutor

pythontutor

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.
    
    1. Activate the virtualenv with
      poetry shell
      .
    2. 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`.

  1. Run npm ci to download dependencies.

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

  1. Go to http://localhost:3000/accounts/login/ and login with the email "[email protected]" and the password "admin".
  2. 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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.