Hello World Novem Tutorial<\/h1>
A complete guide to building your first Novem job that fetches live weather data and updates a custom visualization.<\/p>

What You'll Build<\/h2>

A job that:<\/p>

Fetches current Oslo weather from wttr.in API<\/li>
Updates a custom plot with weather description and temperature<\/li>

Runs automatically or on-demand<\/li> <\/ul>

Prerequisites<\/h2>

Novem account<\/li>
Git configured with SSH keys<\/li>

Visual Studio Code with Novem add-in installed<\/li> <\/ul>

Step 1: Initialize Git Repository<\/h2>

mkdir hello-world
cd hello-world
git init -b main 
<\/code><\/pre>
Step 2: Create Python Script<\/h2>
Create hello_world.py<\/code>:<\/p>
#!\/usr\/bin\/env python3
"""
Hello World Novem Job
Fetches Oslo weather and updates a custom plot
"""
import requests
import pandas as pd
from novem import Plot

def get_oslo_weather():
    """Fetch current weather for Oslo from wttr.in API"""
    url = "https:\/\/wttr.in\/Oslo?format=j1"
    response = requests.get(url, timeout=10)
    data = response.json()

    # Extract temperature and description
    current = data['current_condition'][0]
    temp = float(current['temp_C'])
    description = current['weatherDesc'][0]['value']

    return temp, description

def update_plot(temp, description):
    """Update the hello_oslo plot"""
    # Create DataFrame
    df = pd.DataFrame({
        'description': [description],
        'temperature': [temp]
    })

    # Update plot data
    plt = Plot('hello_oslo')
    plt.data = df

def main():
    # Fetch weather data
    temp, description = get_oslo_weather()

    # Update Novem plot
    update_plot(temp, description)

if __name__ == "__main__":
    main()
<\/code><\/pre>
Create requirements.txt<\/code>:<\/p>
requests
pandas
novem
<\/code><\/pre>
Set up environment and execute script locally :<\/p>
# On Unix\/Mac
python3 -m venv .venv
source .venv\/bin\/activate
pip install -r requirements.txt
python hello_world.py
<\/code><\/pre>
# On Windows
py -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
py hello_world.py
<\/code><\/pre>
Step 3: Create Custom Plot<\/h2>
The Python script references a plot called hello_oslo<\/code>. Create this using the Visual Studio Code Novem add-in:<\/p>

Open the Novem add-in in VS Code<\/li>
Open the plot we created named hello_oslo<\/code><\/li>
Set config\/type<\/code> to custom<\/code><\/li>
Open config\/custom\/custom.js<\/code> and paste the code below:<\/li>
<\/ol>
\/\/ Extract data (skip header row)
const [description, temp] = info.data[1];

\/\/ Set colors
const coldColor = '#3498db';  \/\/ Blue
const warmColor = '#e74c3c';  \/\/ Red
const descColor = render.dark ? '#bdc3c7' : '#7f8c8d';
const backgroundColor = render.dark ? '#1e1e1e' : '#ffffff';

\/\/ Choose temperature color based on 0°C
const tempColor = temp >= 0 ? warmColor : coldColor;

\/\/ Style the container
node.innerHTML = '';
node.style.display = 'flex';
node.style.flexDirection = 'column';
node.style.justifyContent = 'center';
node.style.alignItems = 'center';
node.style.background = backgroundColor;
node.style.padding = '40px';
node.style.fontFamily = 'Arial, sans-serif';

\/\/ Add description
const desc = document.createElement('div');
desc.textContent = description;
desc.style.fontSize = '28px';
desc.style.color = descColor;
desc.style.marginBottom = '30px';
node.appendChild(desc);

\/\/ Add temperature
const tempDiv = document.createElement('div');
tempDiv.textContent = `${temp.toFixed(1)}°C`;
tempDiv.style.fontSize = '72px';
tempDiv.style.fontWeight = 'bold';
tempDiv.style.color = tempColor;
node.appendChild(tempDiv);
<\/code><\/pre>
Step 4: Push to Novem Repository<\/h2>
Create the repo, which you can do from novem.io<\/code>.<\/p>
# Add Novem remote (replace '[username]' with your username, '[repo]' with your repo name 
git remote add origin git@novem.io:[username]\/[repo]

# Commit and push
git add hello_world.py requirements.txt
git commit -m "Initial commit: Oslo weather job"
git push -u origin main
<\/code><\/pre>
Step 5: Create the Job<\/h2>
Create the job using the Visual Studio Code Novem add-in:<\/p>

Open the Novem add-in in VS Code<\/li>
Create a new job named hello-world-oslo<\/code><\/li>
Set config\/type<\/code> to data<\/code><\/li>
Set the extract<\/code> to hello-world<\/code><\/li>
Set config\/env\/novem_token<\/code> to your Novem API token that you can generate from your Novem account settings<\/li>
<\/ol>
Step 6: Run the Job<\/h2>
Trigger the job through from novem.io<\/code>. See the output plot under your plots. There is a log endpoint for the job, here you can see messages to standard out including any error messages. You can see this in VS Code.<\/p>

Hello World Novem Tutorial<\/h1> A complete guide to building your first Novem job that fetches live weather data and updates a custom visualization.<\/p>

Step 6: Run the Job<\/h2> Trigger the job through from novem.io<\/code>. See the output plot under your plots. There is a log endpoint for the job, here you can see messages to standard out including any error messages. You can see this in VS Code.<\/p>

Hello World Novem Tutorial<\/h1>
A complete guide to building your first Novem job that fetches live weather data and updates a custom visualization.<\/p>

Step 6: Run the Job<\/h2>
Trigger the job through from `novem.io<\/code>. See the output plot under your plots. There is a log endpoint for the job, here you can see messages to standard out including any error messages. You can see this in VS Code.<\/p>`