Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
158 changes: 74 additions & 84 deletions content/en/docs/tutorial-ai/Lesson0/_index.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,50 @@
---
title: Lesson 0
weight: 10
draft: true
---

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

perché sia live draft deve essere a false o non esserci, se non si vuole sia subito visibile allora ok


# TO BE REVIEWED!

# 👋 Welcome to the Course: Application Development with LLM Open and Apache Open Serverless

A mileage title worthy of Wertmüller — but for friends, it's simply the **Mastro GPT Course**.
# Welcome to the Course: Application Development with Apache Open Serverless

---

## 🚀 Step 1: Start the Environment
## Step 1: Start the Environment

To start working, launch the development environment.

### 🟢 Recommended: GitHub Codespace
### Recommended: GitHub Codespace
1. Go to **GitHub → Mastro GPT**: https://github.com/mastrogpt
2. Click the **"Code"** button.
3. Select **"Create codespace on main"**.
4. Wait for it to start (takes some time the first time).

> This is the environment used for the course. It's convenient and preconfigured for both training and development.
This is the environment used for the course. It's convenient and preconfigured for both training and development.

---

## ⚙️ Step 2: Explore the Interface Icons
## Step 2: Explore the Interface Icons

Once your Codespace is running, take note of these key icons in the sidebar:

- ☁️ **Cloud icon**: Opens the Open Serverless extension.
- 🧪 **Test tube icon**: Opens the list of tests.
- 📄 **Docs icon**: Opens course documents and slides.
- 🔍 **Search icon**: Lets you search in your code and documents.
- **Cloud icon**: Opens the Open Serverless extension.
- **Test tube icon**: Opens the list of tests.
- **Docs icon**: Opens course documents and slides.
- **Search icon**: Lets you search in your code and documents.

---

## 🔐 Step 3: Login to Open Serverless
## Step 3: Login to Open Serverless

1. Click the **Cloud icon**.
2. Press the **Login** button.
3. Enter your **username and password**.
4. You should see the message:

You have successfully logged in. You can now use Open Serverless.

yaml
Copy
Edit

This concludes the initial setup. This is **Lesson Zero**, a pre-lesson to verify that everything works.
This concludes the initial setup.

---

## 🧪 Step 4: Deploy and Run Tests
## Step 4: Deploy and Run Tests

To ensure your setup is working:

Expand All @@ -65,7 +55,7 @@ To ensure your setup is working:

---

## 🧰 Step 5: Use Development Mode
## Step 5: Use Development Mode

Switch to development mode to run the web interface:

Expand All @@ -74,137 +64,137 @@ Switch to development mode to run the web interface:

If you don’t see the **Open in browser** button:

- Look for the 📡 **Antenna icon** at the bottom bar.
- Click the 🌐 **Globe icon** to open the UI in a browser.
- Look for the **Antenna icon** at the bottom bar.
- Click the **Globe icon** to open the UI in a browser.

---

## 🤖 Step 6: Meet "Pinocchio" — The User Interface

The web frontend is named **Pinocchio**, a reference to Mastro Geppetto.
## Step 6: Meet "Pinocchio" — The User Interface

The web frontend is named **Pinocchio**, a reference to Carlo Collodi's book.
### Default login credentials:
- **Username**: Pinocchio
- **Password**: Geppetto (or vice versa)

> You’ll be prompted to change it. Here’s how.
You’ll be prompted to change it.

---

## 🔁 Step 7: Change the Password (via Terminal)
## Step 7: Change the Password (via Terminal)

1. Open the terminal:
Terminal → New Terminal
1. Open the terminal: Terminal → New Terminal

2. Run the following command:

bash
obs ai user update Pinocchio
Enter your new password.
```ops ai user update Pinocchio```

3. Enter your new password.

4. Redeploy the login service:

Redeploy the login service:
```ops ide deploy mastrogpt-login```

bash
Copy
Edit
obs deploy mastrogpt-login
This shows how command-line tools can be used instead of the GUI for advanced operations.

🧑‍💻 Step 8: Tour the Interface Features
Pinocchio is a multi-chat UI developed in Python. You won't need to change the UI — you'll build backend logic for chat apps.
## Step 8: Tour the Interface Features

> Pinocchio is a multi-chat UI developed in Python. You won't need to change the UI — you'll build backend logic for chat apps.

Available chats:

hello: Responds with a greeting.

demo: Demonstrates Pinocchio’s interface features:

Code rendering
- Code rendering

HTML view
- HTML view

Chessboard display
- Chessboard display

Forms and form submissions
- Forms and form submissions

Document uploads
- Document uploads

Custom side views
- Custom side views

Everything is extendable and customizable.

🧪 Step 9: View the Slides
## Step 9: View the Slides

To view this lesson's materials:

Click the 📄 Docs icon.
1. Click the Docs icon.

Navigate to the lessons/ folder.
2. Navigate to the lessons/folder.

Open the lesson markdown file.
3. Open the lesson markdown file.

Use the Preview tab to view the slide.
4. Use the Preview tab to view the slide.

Use Source to copy exercises or commands.
5. Use Source to copy exercises or commands.

💡 Step 10: Tips for Codespaces
To avoid wasting free hours:
## Step 10: Tips for Codespaces

Go to GitHub → Settings → Codespaces.
To avoid wasting the free hours of Github Codespaces:

Set Auto-off timeout to 5–10 minutes.
1. Go to GitHub → Settings → Codespaces.

Optionally switch from VS Code web to VS Code desktop.
2. Set Auto-off timeout to 5–10 minutes.

Alternatively, install and run everything locally using Docker.
3. Optionally switch from VS Code web to VS Code desktop.

We can organize a dedicated lesson on local installation if needed.
Alternatively, install and run everything locally using Docker.

☁️ Step 11: Open Serverless Services
## Step 11: Open Serverless Services
Your environment includes:

Redis
- Redis

MinIO
- MinIO

PostgreSQL (not required for this course)
- PostgreSQL (not required for this course)

You can deploy apps on:

AWS
- AWS

- Google Cloud

Google Cloud
- Azure

Azure
- Akamai

Akamai
- Hetzner

Hetzner
- Ubuntu

Ubuntu
- OpenShift

OpenShift
## Step 12: Get Support

🆘 Step 12: Get Support
You can request your free account or support via:

🌐 Website: https://mastrogpt.com
- Website: https://mastrogpt.com

- Chatbot on the website

💬 Chatbot on the website
- LinkedIn: Send us a message

💼 LinkedIn: Send us a message
- Discord: Primary support (use the Italian channel if preferred)

💻 Discord: Primary support (use the Italian channel if preferred)
- Reddit: Ask questions and join the discussion

🗣️ Reddit: Ask questions and join the discussion
## Step 13: Start Lesson 1

▶️ Step 13: Start Lesson 1
Now that everything is set up:

Go back to the Cloud icon.
1. Go back to the Cloud icon.

Click Lessons.
2. Click Lessons.

Select Lesson 1.
3. Select Lesson 1.

All lesson files will be downloaded automatically.
4. All lesson files will be downloaded automatically.

You're now ready to start building!
You're now ready to start building!
Loading