Learn

Plain English for the Developer Guide

If the Developer Guide feels like a different language, start here. This page is a short glossary plus a set of ready-to-paste prompts you can drop into an AI chat tool like Microsoft 365 Copilot. Use them to walk yourself through practical setup tasks — installing Python, using a terminal, cloning a repo. No full programming course. Just enough to make the guide make sense.

Back to Developer Guide

This is a reading companion for the Developer Guide. Its only job is to help you understand what the guide is talking about. You will not learn to write code from scratch here — you will learn just enough to recognise what each tool, word, and step means, then go back and follow the guide.

The trick is to let an AI chat walk you through the practical setup. Every section below gives you a ready-to-paste prompt scoped to one specific task: installing Python, opening a terminal, cloning a repo, running a Streamlit app, and so on. Streamlit is the simplest path for most consultant tools; if you are building a non-Streamlit React/FastAPI app, start from the custom template linked in the Developer Guide.

Is Streamlit approved for ERM use?

Short answer: Streamlit is a supported application framework within the AI Marketplace deployment pattern. That is not the same as approving Streamlit as a standalone ERM application or SaaS service. The Developer Guide is implementation guidance, not ERM's approved-software register. The guide refers to the open-source Python framework used inside an AI Marketplace app; it does not approve Streamlit Community Cloud, another externally hosted Streamlit service, or arbitrary standalone deployments.

What the Developer Guide coversWhat it does not authorise
A Python app built from the supported template, packaged and deployed in ERM's AWS environment, and accessed through the AI Marketplace with ERM sign-in and platform controls. Publishing the app to Streamlit Community Cloud, using an independent external Streamlit host, making a public deployment, or bypassing AI Marketplace authentication and deployment controls.

Think of Streamlit here as a library inside the application, not as a separate SaaS product that ERM users sign into. The framework being available in the AI Marketplace delivery pattern is also not blanket approval for every application, dataset, integration, or use case. Each app must still follow the Marketplace's repository, SSO, hosting, security, data-handling, testing, and deployment requirements, with app-specific review where required.

If your app will process client confidential or sensitive data, connect to another system, or needs restricted access, do not assume the framework choice settles the approval question. Follow the AI security and client data guidance and raise the app-specific question with the relevant platform or governance owner.

What to tell the Service Desk

First confirm whether they mean Streamlit Community Cloud or the open-source framework inside an AI Marketplace-hosted app. You can send this wording:

The Developers page is implementation guidance for AI Marketplace apps rather than ERM's approved-software register. It refers to Streamlit as the open-source Python framework used inside applications deployed through ERM's AI Marketplace. It does not authorise Streamlit Community Cloud or a separate standalone Streamlit service. The resulting application is hosted in ERM's AWS environment and remains subject to AI Marketplace sign-in, hosting, security, data-handling, testing, deployment, and app-specific review requirements. Could you confirm whether the concern applies to Streamlit Community Cloud or other standalone use, or to the framework packaged inside an ERM AI Marketplace-hosted application?

Quick cheat sheet

One-line definitions of every word the Developer Guide throws at you, grouped by topic. Use this as a glossary while you read — these are the handful of things you need to recognise.

Python, Git, and Visual Studio Code should already be in your ERM self-service catalog and install automatically with no approval required. If one of those apps is missing from your catalog, raise a Technology Support request.

Python and your app

WordWhat it actually is
PythonA programming language. You write your tool's code in Python
StreamlitThe simplest app framework for most consultant tools. It turns a Python file into a live webpage — no HTML needed. Your main file is typically app.py.
React + FastAPIThe custom-app path for non-Streamlit cases that need a richer UI, protected backend routes, file processing, or workflow control. Use the ai-marketplace-custom-app-template.
PoetryA helper that manages which Python libraries your app needs

Commands you will type

CommandWhat it does
poetry installInstall all the libraries your app depends on (run from inside your repo folder, once after cloning)
poetry add package-nameAdd a new library to your app (replace package-name). Use this instead of editing files by hand
poetry run streamlit run app.pyStart your app on your own computer so you can test it in a browser at http://localhost:8501
Ctrl + CStop your app when you are done testing (press this in the terminal where it is running)

Git and GitHub

WordWhat it actually is
GitA tool that tracks changes to your code and syncs them with GitHub
GitHubA website where code is stored — like Google Drive, but for code projects. You need membership in ERM's GitHub org; use the GitHub access request instructions in the Developer Guide.
Repo (repository)A single project folder on GitHub
Org (organisation)A group on GitHub that owns repos. Marketplace app repos should usually be in ERMInc.
Template repoA starter project you copy to begin your own. Streamlit currently uses capability-tool-template, but new app repos should still be named ai-marketplace-<name>. Custom React/FastAPI apps use ai-marketplace-custom-app-template.
Main branchThe official version of the code on GitHub
CloneDownload a copy of a GitHub repo to your own computer
CommitSave a change you have made, with a short message describing it
PushUpload your saved changes from your computer to GitHub
PullDownload the latest changes from GitHub to your computer

Commands you will type

CommandWhat it does
git config --global user.name "Your Name"First-time setup — tell Git who you are so your commits are labelled
git config --global user.email "[email protected]"First-time setup — set your email for commit history
git clone <repo-url>Download a GitHub repo to your computer for the first time
git statusSee which files you have changed since your last commit
git add .Stage all your changes, ready to commit
git commit -m "describe your change"Save a checkpoint with a short message explaining what you changed
git pushUpload your commits to GitHub. Before dev deployment, obtain Requirements Agent use-case approval. Push ready code to main, then use the Developer Guide request form with the submitted PRD link from All requests.
git pullDownload the latest changes from GitHub to your computer

Where you write and run code

WordWhat it actually is
TerminalA text window where you type commands to your computer. Also called the command line or CLI
Editor / IDEThe program where you write and edit code. VS Code is one example

Commands you will type

CommandWhat it does
pwdShow which folder you are currently in
ls (Mac) / dir (Windows)List all files and folders in the current folder
cd folder-nameMove into a folder (replace folder-name with your folder's name)
cd ..Move up one level, out of the current folder

This platform

WordWhat it actually is
DeployPublish your code so it runs on the internet as a live webpage
call_llmA helper provided by this platform that lets your app talk to an AI model (powered by AWS Bedrock) without any setup

AI helpers

WordWhat it actually is
Microsoft 365 CopilotThe AI chat assistant in Teams, Word, and the Microsoft 365 home. ERM provides it
GitHub CopilotA different Copilot that runs inside a code editor and writes code with you. Separate license

Deploy prerequisites

These are not terms but hard rules — get any of them wrong and your deploy will fail. Keep them in mind before your first push.

RuleWhat it means
Repo name prefixNew Streamlit and custom React/FastAPI apps use ai-marketplace-<name>. Existing capability-tool-* repos are legacy-supported, but new apps should not use that prefix.
IT Service Desk registrationBefore your tool can deploy to prod, IT must register your tool name in Azure AD. Raise a Service Desk ticket — see the Developer Guide deploy flow for the ticket body

Streamlit basics

These are the Streamlit building blocks, copyable patterns, and rerun rules most tools need. Use this section if you are building with Streamlit. For non-Streamlit React/FastAPI apps, use the Developer Guide and the custom app template instead.

The template repo also includes runnable examples in examples/cheat_sheet.py.

Components

I need to...Use this
Upload a filest.file_uploader("Label", type=["csv", "xlsx", "pdf"])
Show a tablest.dataframe(df) for an interactive table, or st.table(df) for a static table
Let the user download a resultst.download_button("Download", data=..., file_name="out.xlsx")
Show more Streamlit components
I need to...Use this
Show a running spinnerwith st.spinner("Working..."):
Show multi-step progresswith st.status("Running...", expanded=True) as s:
Side-by-side layoutcol1, col2 = st.columns(2)
Tabbed sectionstab1, tab2 = st.tabs(["A", "B"])
Hide details until expandedwith st.expander("Show more"):
Batched form submissionwith st.form("key"): plus st.form_submit_button()
Persist values across rerunsst.session_state["key"] = value
Cache an expensive call@st.cache_data for data, or @st.cache_resource for models and clients

Common patterns

Short snippets you can copy into app.py. Each is complete and runnable.

Upload, parse, preview
import streamlit as st
import pandas as pd

uploaded = st.file_uploader("CSV or Excel", type=["csv", "xlsx"])
if uploaded:
    df = pd.read_csv(uploaded) if uploaded.name.endswith(".csv") else pd.read_excel(uploaded)
    st.dataframe(df.head(20))
    st.metric("Rows", len(df))
Call the LLM with a spinner
import streamlit as st
from platform_config import call_llm

text = st.text_area("Paste your text")
if st.button("Summarize") and text:
    with st.spinner("Thinking..."):
        result = call_llm(f"Summarize in 3 bullets:\n\n{text}")
    st.write(result)
Export a DataFrame to Excel
import io
import pandas as pd
import streamlit as st

df = pd.DataFrame({"name": ["Alice", "Bob"], "score": [92, 78]})

buf = io.BytesIO()
with pd.ExcelWriter(buf, engine="openpyxl") as writer:
    df.to_excel(writer, index=False, sheet_name="Results")

st.download_button(
    "Download Excel",
    data=buf.getvalue(),
    file_name="results.xlsx",
    mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
)
Multi-step progress with st.status
import streamlit as st

with st.status("Processing...", expanded=True) as status:
    st.write("Step 1: Loading data")
    # ... work ...
    st.write("Step 2: Running analysis")
    # ... work ...
    st.write("Step 3: Building report")
    status.update(label="Done", state="complete")

State and reruns

Streamlit re-runs your entire script top-to-bottom on every interaction. If you need a value to survive, put it in st.session_state.

SituationUse
A variable must survive between clicksst.session_state["my_key"]
An expensive computation should only run once per input@st.cache_data
A client or model should load only once per session@st.cache_resource
You want to force a rerun from codest.rerun()
You need user input before doing workGate the logic behind if st.button(...) or st.form_submit_button()

AI-based learning

If the cheat sheet above is not enough and you want an AI to walk you through something hands-on — installing Python, using a terminal, decoding an error — the prompts below will do the heavy lifting. Each one is a ready-to-paste question scoped to a single task.

Where to paste them

Microsoft 365 Copilot is the easiest starting point if ERM has already given you a license. Open it from the Copilot icon in Microsoft Teams, or go to m365.cloud.microsoft/chat and sign in with your ERM email.

If you do not have a Copilot license yet, raise a ticket with the IT Service Desk to request Microsoft 365 Copilot access. If you already use a different AI chat tool, that works too — the prompts are plain text and any modern AI chat can answer them. Do not paste client confidential or sensitive data into AI tools unless the use case has been assessed; see the AI security and client data guidance.

How to use a prompt

Copy the whole prompt (including the blank lines), paste it into a new chat, and have a short conversation. When you are done with one topic, start a fresh chat for the next so the AI starts clean. These are suggestions — skip any you already know how to do.

1. Install Python, Poetry, Git, and a code editor

Use when: you are setting up your computer from scratch.

I need to install four tools on my [Mac / Windows — tell me which] computer so I can build a Python web app. Python, Git, and Visual Studio Code should already be in my ERM self-service catalog and should install automatically from there with no approval required. Only use this Technology Support request link if one of those apps is missing from my catalog: https://support.erm.com/app/itservices/ui/requests/add?reqTemplate=12301000134532167 The tools are: 1. Python 3.14.2 (the programming language) 2. Poetry (a Python dependency manager) 3. Git (a version-control tool used to upload code to GitHub) 4. A code editor (Visual Studio Code from the ERM self-service catalog — or any other editor I already use) Walk me through installing all four, one at a time, step by step. For each tool: - Tell me whether to use the ERM self-service catalog or a command - For Python, Git, and Visual Studio Code, tell me to search the ERM self-service catalog and click Install - Tell me how to verify the install worked (what to type to check the version) - Warn me about common mistakes beginners make I have never done this before. Assume I do not know terms like "PATH" or "terminal" and define them as you go. Stop after each tool and wait for me to say "done" before moving to the next.

2. Use a terminal for the first time

Use when: you need to run commands on your computer but have never opened a terminal.

I have never used a terminal before. I am on [Mac / Windows]. Teach me the basics. I need to understand: 1. How to open a terminal on my computer (click-by-click) 2. What a command is and how to run one 3. The 5 most useful commands I will need: pwd, ls (or dir on Windows), cd, mkdir, and how to cancel a stuck command with Ctrl+C 4. What happens when I see a "$" or ">" at the start of a line 5. What to do if I type a command and get "command not found" For each command, show me exactly what I type AND what I should see when it works. Go one command at a time and ask me to confirm before moving on.

3. Connect Git to GitHub and clone a repo

Use when: you have Git installed and need to download a project from GitHub to your computer.

I have Git installed on my [Mac / Windows] computer and a GitHub account. I need to: 1. Tell Git who I am — set my name and email globally so my commits are identified 2. Authenticate with GitHub so I can download and upload code. Walk me through the simplest beginner-friendly method (either HTTPS with a Personal Access Token, or the GitHub CLI "gh auth login") and tell me which one you recommend for a first-timer 3. Clone a specific GitHub repository to my computer. The repo URL is: [PASTE THE REPO URL HERE] 4. Verify the clone worked — confirm I can see the files on my computer Walk me through each step one at a time. Show me the exact commands I type in the terminal and explain what each one does. Assume I have never used Git before.

4. Run a Streamlit app on your own computer

Use when: you have a folder with a Python file called app.py and want to see it as a web page on your own machine.

I have a folder on my computer that contains a Python file called app.py. The file uses a library called Streamlit. I have Python and Poetry installed. I want to run this app on my own computer so I can see it in a web browser. Walk me through the exact commands, step by step, from opening a terminal to seeing the app open in my browser. Cover: 1. How to navigate to the folder in the terminal (using "cd") 2. How to install the libraries the app needs (using "poetry install") 3. How to start the Streamlit app (the exact command) 4. What I should see in the terminal when it is working 5. What URL to open in my browser 6. How to stop the app when I am done Assume I have never used Poetry or Streamlit before. Show me exactly what to type.

5. Commit and push changes back to GitHub

Use when: you edited a file in a cloned repo and need to upload the changes back to GitHub.

I cloned a GitHub repo to my computer and edited a file. Now I want to save the changes and upload them back to GitHub using Git from the terminal. I am on [Mac / Windows] and I have never done this before. Walk me through it step by step. Cover: 1. How to see which files I changed (git status) 2. How to stage a changed file (git add) 3. How to commit the staged change with a message (git commit -m "...") 4. How to push the commit to GitHub (git push) 5. How to verify on GitHub.com that my change actually arrived For each command, show me the exact text I type AND the message I should expect to see when it worked. Tell me what the most common errors look like ("rejected", "authentication failed", "nothing to commit") and how to fix them.

6. Decode a Python error message

Use when: you ran a command and got a wall of red text you do not understand.

I am a beginner building a web tool with Python and Streamlit. I ran a command and got this error. I do not understand it: [PASTE THE FULL ERROR MESSAGE HERE] Please: 1. Translate the error into plain English — what was the computer trying to do when it failed? 2. Tell me the most likely cause 3. Give me 2 or 3 things to try, from easiest to hardest 4. Tell me how to verify each fix worked 5. If none of those work, tell me what to try next Do not lecture me on Python. Just help me fix this specific problem.

7. Show me the Streamlit widgets I can use

Use when: you see widgets like st.text_input in code and want to know what options exist.

I am building a simple internal web tool using Streamlit. I have no frontend experience — no HTML, no CSS, no JavaScript. Show me the 10 most common Streamlit widgets I would use to build a typical internal tool. For each widget, give me: 1. The widget name (for example st.text_input) 2. What it looks like on the page, described in plain English 3. The one line of Python code that adds it 4. A real use case (for example "ask the user for their email address") Skip anything exotic. At the end, show me a complete 15-line example app.py that combines five of these widgets into one working form.

When you are ready

You are ready to go back to the Developer Guide when you have done these things at least once:

Can you do this?
Install Python, Poetry, Git, and a code editor on your computer
Open a terminal and run a basic command
Clone a GitHub repo to your computer
Run a Streamlit app locally with poetry run streamlit run app.py, or run the custom React/FastAPI template's backend and frontend from its README.
Commit a change and push it to GitHub

If any of those are still fuzzy, check the cheat sheet above, try the relevant AI prompt, or ask someone who has done it before. Once you can do all five, head back to the Developer Guide — you will recognise almost everything it asks you to do.