Project Description

Immersive system to run interactive tutorials, hacking learning lessons or just games that integrates with your system. The main idea is to have an INK language engine to process the tutorial scripts and provide an interactive user interface to the user. The system should be able to listen to different Linux events (like filesystem changes, process is running, the current date, etc) and modify the tutorial state depending on that.

Example: * We've a tutorial to learn about how to use the linux terminal, a bash introduction * The tutorial gives to the user a brief explanation about how to create a directory and waits for the directory to be created * Once the system detects that directory, it automatically go forwards, says congrats to the user and continues with the next step

The main idea is to build the base system with Python and provide a generic interface (dbus, socket, cli) to be able to extend and use from different languages.

This idea is based on the Hack Computer concept, but trying to make it simpler and not tied to the desktop. It's a simple concept to have a way to create a more fun learning experience using a Choose Your Own Adventure like tutorial flow, with different user input that can happen in a different process.

Goal for this Hackweek

This is the full list of goals that will be great to have, in order of importance:

  1. Build a basic python Ink language interpreter
  2. Create the base system that runs the tutorial, keep the state and provide an API to be used
  3. Make the base system extensible with listeners that can wait for different kind of events:
    • user option selection
    • user text input
    • new file
    • date change
    • launch program, close program
    • system reboot?
    • ...
  4. Create initial tutorial about how to write lils tutorials / games
  5. Create different graphical user interfaces (GNOME shell plugin, desktop application, web interface...)

https://github.com/danigm/lils

Resources

python game tutorial learning scripting ui

Looking for hackers with the skills:

python game learning scripting tutorial

This project is part of:

Hack Week 22

Activity

  • over 2 years ago: cdywan liked this project.
  • over 2 years ago: robert.richardson liked this project.
  • over 2 years ago: ybonatakis liked this project.
  • over 2 years ago: kstreitova liked this project.
  • over 2 years ago: dgarcia started this project.
  • over 2 years ago: dgarcia added keyword "python" to this project.
  • over 2 years ago: dgarcia added keyword "game" to this project.
  • over 2 years ago: dgarcia added keyword "learning" to this project.
  • over 2 years ago: dgarcia added keyword "scripting" to this project.
  • over 2 years ago: dgarcia added keyword "tutorial" to this project.
  • over 2 years ago: dgarcia originated this project.

  • Comments

    Be the first to comment!

    Similar Projects

    Advent of Code: The Diaries by amanzini

    Description

    It was the Night Before Compile Time ...

    Hackweek 25 (December 1-5) perfectly coincides with the first five days of Advent of Code 2025. This project will leverage this overlap to participate in the event in real-time.

    To add a layer of challenge and exploration (in the true spirit of Hackweek), the puzzles will be solved using a non-mainstream, modern language like D, Crystal, Gleam or Zig.

    The primary project intent is not just simply to solve the puzzles, but to exercise result sharing and documentation. I'd create a public-facing repository documenting the process. This involves treating each day's puzzle as a mini-project: solving it, then documenting the solution with detailed write-ups, analysis of the language's performance and ergonomics, and visualizations.

                                   |
                                 \ ' /
                               -- (*) --
                                  >*<
                                 >0<@<
                                >>>@<<*
                               >@>*<0<<<
                              >*>>@<<<@<<
                             >@>>0<<<*<<@<
                            >*>>0<<@<<<@<<<
                           >@>>*<<@<>*<<0<*<
             \*/          >0>>*<<@<>0><<*<@<<
         ___\\U//___     >*>>@><0<<*>>@><*<0<<
         |\\ | | \\|    >@>>0<*<0>>@<<0<<<*<@<<
         | \\| | _(UU)_ >((*))_>0><*<0><@<<<0<*<
         |\ \| || / //||.*.*.*.|>>@<<*<<@>><0<<<
         |\\_|_|&&_// ||*.*.*.*|_\\db//_
         """"|'.'.'.|~~|.*.*.*|     ____|_
             |'.'.'.|   ^^^^^^|____|>>>>>>|
             ~~~~~~~~         '""""`------'
    ------------------------------------------------
    This ASCII pic can be found at
    https://asciiart.website/art/1831
    
    

    Goals

    Code, Docs, and Memes: An AoC Story

    • Have fun!

    • Involve more people, play together

    • Solve Days 1-5: Successfully solve both parts of the Advent of Code 2025 puzzles for Days 1-5 using the chosen non-mainstream language.

    • Daily Documentation & Language Review: Publish a detailed write-up for each day. This documentation will include the solution analysis, the chosen algorithm, and specific commentary on the language's ergonomics, performance, and standard library for the given task.