Download CLASSROOM.md from Devseis/Ora: direct link, hf CLI and curl.
- Browser
- Download file 6.93 kB
-
https://huggingface.co/spaces/Devseis/Ora/resolve/main/CLASSROOM.md
- Command line
-
hf download hf://spaces/Devseis/Ora/CLASSROOM.md
-
curl -L -o CLASSROOM.md https://huggingface.co/spaces/Devseis/Ora/resolve/main/CLASSROOM.md
Running Ora in class
A guide for trainers using Ora 0.6 in a marketing course, for example a three-day "Digital Marketing for Beginners" course. Each participant builds a campaign for their own brand: brand identity, personas, competitors, campaign, a 30-day calendar with posters and captions, results and a final presentation.
Before the course
Each laptop (macOS, Windows or Linux; any laptop from the last few years, no graphics card needed):
- Install Ora with one command from the Ora page: Terminal on macOS/Linux, PowerShell on Windows.
- Windows may show "Windows protected your PC": click More info › Run anyway (Ora is not yet code-signed).
- On macOS, the first time Ora stores the Cloudflare key, macOS may ask for the login keychain password. That is normal.
- Ora opens on its setup page. Ask every participant to make a free Cloudflare account and connect it there (Account ID + a Workers AI API token; the page shows the three steps). With it:
- ✨ Draft with AI, Suggest, the coach, captions and Explain my results are written by an AI text model;
- posters and portraits take a few seconds each;
- each account has about 170 pictures a day for free, which is plenty for a class. Participants can Skip for now: Ora then writes simpler drafts, ideas and captions itself, and asks again when a ✨ button needs Cloudflare. Pictures need Cloudflare.
- For Day 3 (automation), optional: each participant makes a free n8n Cloud account (n8n.io). Ora asks for it only when it is needed: Settings › Accounts › n8n shows the six steps with a sketch of each page (save Ora's automation file, import it in n8n, publish, paste its link). Then Settings › Automations walks through Google Sheets, Gmail and LinkedIn, one card each.
How Ora teaches
The eight steps are in the sidebar: Brand, Personas, Competitors, Campaign, Content plan, Campaigns, Results, Presentation. Settings (Accounts, Automations) sit at the bottom. A step shows ✓ when its checks pass, and the sidebar shows overall progress. Each step has a To do line and Show guide: what it is, why it matters, a good example, what to do, and key words.
- ✨ Draft with AI (Brand, Personas, Competitors, Campaign, Content plan): from the brand name and what it offers, Ora drafts the rest; on Personas it also makes the portraits. Drafted fields carry an AI draft label until the participant edits them or presses Keep, so it is always clear what is theirs. A good exercise: let AI draft, then improve it and explain why.
- Check my work and Next: the fields that still need something are outlined in red with a note, like a form; Go on anyway moves on when a participant wants to come back later. The coach also writes what is good, what to improve, and a score.
- Open the demo: a finished example, the café Bean & Bloom, with every step done, portraits, a filled calendar with posters and captions, results and a presentation. Show it on Day 1 so everyone sees the goal. Back to my plan returns to their own work; the demo never changes it.
Course plan
| Day · topic | In Ora | Deliverable |
|---|---|---|
| Day 1 · Brand | 1 · Brand: name, offer, mission (✨ Suggest), values, personality, tone, tagline (✨ Suggest), colours, font, logo. No brand yet? Click the plan name at the top of the sidebar › Start from an example (café, fitness trainer, clothing brand, startup, personal brand). | Save Brand Identity Summary → PNG + PDF in Documents/Ora |
| Day 1 · Audience | 2 · Personas: two personas with gender, age, job, needs, frustrations, motivations and where they are online. ✨ Make portrait makes a matching picture. Mark one as Main. | Two persona cards (in the summary) |
| Day 1 · Presence | 3 · Competitors › Digital presence map: tick the channels, each with its purpose and how often; Ora shows which persona each one reaches. | Digital presence map |
| Day 2 · Competitors | 3 · Competitors: two competitors (where they post, what works, how they position themselves) and How we are different. ✨ Draft with AI suggests kinds of competitor; replace them with real ones. | Two competitors analysed |
| Day 2 · Campaign | 4 · Campaign: name and key message (✨ Suggest), goal, value proposition, offer, call to action, channels; the funnel with one piece of content per step (✨ Make picture makes a poster for each); 3 success metrics with targets. | Campaign, funnel and targets |
| Day 2 · Content | 5 · Content plan: ✨ Suggest ideas (10+ ideas across the content types), add your own, then Fill the month. Click a day to change it, ✨ Make picture and ✨ Write captions. ✨ Make the month's posts makes a poster with captions for every planned day. Export to Google Sheets (CSV) or a calendar (.ics). | 10 ideas, a 30-day calendar, 2+ finished posts |
| Day 3 · Automation | Settings › Automations: set up Google Sheets, Gmail reminders and LinkedIn posts in n8n, step by step, then Send the month to n8n. 6 · Campaigns: open the sent month and look at its days; Delete removes a day's rows and stops its waiting reminder and LinkedIn post. | A content sheet, reminders and a scheduled LinkedIn post |
| Day 3 · Analytics | 7 · Results: Add posts from the calendar (days marked Posted) or Add a post, type the numbers from Instagram/Facebook/LinkedIn insights, or import a CSV. Ora works out the engagement rate, progress to each target, the best post and the best kind of content; ✨ Explain my results writes what worked and what to do next month. | Three success metrics, measured |
| Day 3 · Presentation | 8 · Presentation: one click makes the deck as PDF or PowerPoint (.pptx) to edit. | Final campaign presentation |
Participants can save their plan to a file (click the plan name at the top of the sidebar › Save my plan to a file) to hand it in or continue on another computer, and Open a plan file… to load it again.
Good to know
- Cloudflare's safety filter refuses adult content. Ora shows a plain message; reword the idea.
- Privacy: plans and pictures stay on the laptop. The words an ✨ button or a picture needs go to the participant's own Cloudflare account; posts sent to n8n go to the participant's own n8n.
- LinkedIn from the demo: posts sent from the demo café are real posts on the participant's LinkedIn. Delete them in 6 · Campaigns before their time if that was only a try.
- Each participant's work is saved in Pictures › Ora and Documents › Ora.
- Need video? The previous version, Ora 0.4.3, makes videos and ads on the computer or a free online GPU.