> For the complete documentation index, see [llms.txt](https://vincenzo-lomonaco.gitbook.io/teaching-h-ckathon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vincenzo-lomonaco.gitbook.io/teaching-h-ckathon/getting-started.md).

# Getting Started

Some Technical info to help you prepare the H\@ck!

Here you'll find more technical information about the <mark style="background-color:orange;">TEACHING H\@ckathon</mark>!

{% hint style="info" %}
*Remember to **bring your Laptop** with you! (and your* [*rubber duck*](https://en.wikipedia.org/wiki/Rubber_duck_debugging) :duck:*)*
{% endhint %}

### :detective: <mark style="background-color:blue;">Rules</mark>

The only rules are:

1. Start coding from scratch during the H\@ck day.
2. No code sharing among different teams.
3. The **use of the TEACHING platform is mandatory**.
4. While we provide a Starting App Kit, a Rasbperry and a camera module, their usage is **not mandatory**
5. We value <mark style="background-color:green;">creativity</mark> and <mark style="background-color:orange;">complexity</mark>: the most *surprising app* will win the H\@ackathon!

### :books: <mark style="background-color:purple;">Before the H\@ck</mark>

Before joining us the 30th of June in one of our locations, please consider getting a bit familiar with the following material / tools:

* [Tensorflow](https://www.tensorflow.org/guide/keras?hl=it) and [Keras](https://keras.io/api/applications/)
* [Docker](https://www.docker.com/) and [Docker Compose](https://docs.docker.com/compose/)
* [Linux / Raspbian OS](http://www.raspbian.org/)
* [RPI camera module](https://projects.raspberrypi.org/en/projects/getting-started-with-picamera)
* [PuTTy and SSH](https://www.putty.org/)
* [Connecting Laptop to Raspberry via Eth](https://www.electronicwings.com/users/SforShortcuts/projects/3021/connecting-raspberry-pi-with-your-laptop-using-ethernet-cable)
* [RabbitMQ](https://www.rabbitmq.com/) and [Pika](https://pika.readthedocs.io/en/stable/)

### :computer: <mark style="background-color:green;">During the H\@ck</mark>

During the Hackathon you will learn about:

* [TEACHING platform](https://github.com/EU-TEACHING)
* How to create a custom module in the [AI-Toolkit](https://github.com/EU-TEACHING/teaching-ai-toolkit)
* How to create your own [TEACHING app](https://github.com/EU-TEACHING/teaching-app) and run it on a Raspberry PI or your laptop
* How to craft a presentation and pitch your app to the Jury!

{% file src="/files/O3uEmiTJtGbCXYaLuK2U" %}
Presented Slides
{% endfile %}

### :package: <mark style="background-color:red;">Starting App Kit</mark>

At the start of the Hack day, we will show you a working example of a TEACHING up and how you can use it as a starting point for your own!&#x20;

The app essentially is build on three main micro-services. It captures an image every 15 seconds, forwards it on a rabbitmq channel and on the other end an AI-Toolkit module classifies it with a Keras pre-trained model on imagenet.

This can be used as a starting point for more interesting apps but remember: working with the RPI is hard as those have only 1GB of RAM! -> ***Start simple!*** :smile:

### :trophy: <mark style="background-color:orange;">Win the H\@ck!</mark>

By the end of the Hackathon we expect you to be able to **create and run a custom TEACHING app** with your <mark style="background-color:purple;">crazy idea</mark>, pitch it to the jury and bring the prizes home! :smile::tada:

### :question:FAQ

> *I'm worried, I don't know anything about this stuff, should I really join?* :cry:

Don't worry buddy, we got you! :smile: In every location there will be some support stuff that will help your team out!

> *Should I prepare in some way before the H\@ckhathon?*

A preparation is not required, we will explain all the necessary details during the Hack day! However, we suggest to go through the [#before-the-h-ck](#before-the-h-ck "mention") material and tools if you have time.