๐ AoK AI-Tutoring Framework Professor Web App Manual Course Authoring, AI Co-Professor & Publishing โ Browser Edition Version 1.0 | April 2026 tutor.academyofknowledge.org |
Table of Contents
1. Introduction โ Create & Publish From Any Browser
The AoK AI-Tutoring Web App gives you full Professor access โ Create Interface, Co-Professor Agent, Import Wizard, and Publishing โ directly in a browser. No installation required.
Figure 1: The Professor Creator Interface running in a browser at tutor.academyofknowledge.org
Everything you can do in the desktop app is available in the browser โ with one exception: Google Sites import requires the desktop app's embedded browser engine. All other import sources (Google Drive, Public URL, File Upload, and AI Skeleton) are fully supported.
Your professor account, courses, and XP are fully shared between the desktop and web apps. Changes saved or published in the web app are immediately visible in the desktop app and to your students.
1.1 Desktop vs Web App โ Professor Feature Comparison
Feature | Desktop App | Web App |
Installation required? | Yes โ Windows/macOS | No โ any browser |
Workspace setup (Root Path)? | Yes โ one-time setup | Not required |
Professor Selection Screen? | Yes | No โ direct to creator |
Create/Import/Publish | Full | Full |
Import Wizard sources | Drive, URL, Local, Google Sites, AI Skeleton | Drive, URL, File Upload, AI Skeleton (no Sites) |
Google Sites import | Yes (requires desktop browser engine) | Not available (requires browser engine) |
Co-Professor Agent | Full | Full |
Node Reorder & Reparent | Yes | Yes |
Media Preview | Full (all formats) | Full (all formats) |
Cloud Browser & Sharing | Yes | Yes |
Works offline? | Partial | No โ requires internet |
Best for... | Long sessions, Google Sites ingestion | Quick edits, any device |
๐ก For routine course edits, content updates, and publishing โ the web app is fully capable. Use the desktop app when you need to import from Google Sites. |
2. Logging In as a Professor
Open your browser and navigate to tutor.academyofknowledge.org. The login portal appears automatically.
Figure 2: The Professor login portal in the browser โ select Professor role before signing in
- Click Professor in the role toggle at the top of the login card.
- Confirm the Sign In tab is active.
- Enter your professor username and password.
- Click Sign In.
The Creator Interface loads directly. There is no Professor Selection Screen in the web app โ your course library is loaded automatically from the server.
๐ก No Root Path setup is needed in the web app. Course storage is handled server-side โ nothing is stored on your local computer. |
2.1 First-Time Registration
Professor accounts require an invite code from the system administrator.
- Click Create Account and select the Professor role.
- Enter a username, password, and email address.
- Enter your invite code in the Invite Code field.
- Click Register. Your account is active immediately.
โ ๏ธ Keep your invite code confidential. Without it, no new professor accounts can be registered. |
3. The Web Creator Interface
The Creator Interface in the web app has the same three-panel layout as the desktop version. It is accessed immediately after login โ there is no separate Selection Screen.
Figure 3: The Web Creator Interface โ Hierarchy Architect (left), Media Preview (centre), Co-Professor Agent (right)
Panel 1 โ Hierarchy Architect (Left Sidebar): Build and organise your course hierarchy. Right-click any node for the full context menu including reordering and reparenting.
Panel 2 โ Media Preview (Centre): Click any attached file, YouTube link, or Google Doc to preview it instantly.
Panel 3 โ Co-Professor Agent (Right): Chat with your AI collaborator, propose and approve structural changes, or generate lecture notes.
3.1 The Web Toolbar
Figure 4: The Web Creator toolbar โ Save, Compile, Publish, Import Wizard, Cloud Browser, and AI toggle
All professor actions are available from the toolbar across the top of the screen:
- Save โ saves the current authoring state to the server.
- Compile โ runs AI semantic summarisation across all lesson content.
- Publish โ packages and syncs the course to the cloud for students.
- Import Wizard โ opens the web import wizard.
- Cloud Browser โ browse and download published courses.
- AI button โ toggle the Co-Professor Agent panel open/closed.
- Avatar โ access profile settings.
4. Building Course Structure
Course structure in the web app works identically to the desktop app. Courses follow the four-level hierarchy: Course โ Module โ Topic โ Lesson.
4.1 Creating Nodes
- Right-click on a parent node (or empty space for a new course).
- Select Add Child from the context menu.
- Enter the node name and press Enter.
- The new node appears immediately in the tree.
๐ก The web app automatically infers the correct level (Module / Topic / Lesson) based on the parent. |
4.2 The Context Menu
Figure 5: Right-click context menu โ reorder and reparent options highlighted in teal
Right-clicking any tree node opens the full context menu with all available actions:
- Rename โ edit the node name in place.
- Add Child Node โ add a new child at the correct hierarchy level.
- Move Up / Move Down โ reorder within siblings (NEW).
- Move To... โ relocate to a different parent (NEW).
- Attach Video / Attach PDF / Add Supplement โ content attachment.
- Delete Node โ permanently removes the node and all children.
4.3 Reordering Nodes โฌ๏ธโฌ๏ธ
Move any sibling node up or down within its parent using the context menu:
- Right-click the node you want to move.
- Select โฌ๏ธ Move Up or โฌ๏ธ Move Down.
- The tree refreshes immediately.
- Click Save to persist the change.
4.4 Reparenting Nodes ๐ Move To
Figure 6: Move To dialog โ select a compatible destination parent
- Right-click the node you want to relocate.
- Select ๐ Move To... from the context menu.
- The Move To dialog shows all valid destination parents.
- Click the target parent, then click Move Here.
- The tree refreshes with the node in its new location.
- Click Save to persist.
โ ๏ธ Valid destination parents are filtered by hierarchy level. A Lesson can only move under a Topic; a Topic can only move under a Module. |
5. Web Import Wizard
The Web Import Wizard supports four content sources. It cannot import from Google Sites (which requires the desktop app's embedded browser engine) but supports all other sources.
Figure 7: Web Import Wizard โ File Upload tab selected (drag-and-drop zone)
- Click Import Wizard in the toolbar.
- Select a source tab at the top of the wizard.
- Follow the steps for your chosen source (see below).
- Review the file list and mapping.
- Click Import Selected Files.
Source 1: Google Drive Folder
Import directly from a Google Drive folder you share with the system.
- Click the Google Drive tab.
- Paste your Google Drive folder link in the URL field.
- Click Connect. The wizard lists all files in the folder.
- Review the mapping, then click Import.
๐ก The folder link must be set to "Anyone with the link can view" in Google Drive sharing settings. |
Source 2: Public URL
Import content from any publicly accessible web page.
- Click the Public URL tab.
- Paste the URL and click Fetch.
- A content preview appears. Review and click Import.
Source 3: File Upload
Upload files directly from your computer.
- Click the File Upload tab.
- Drag files onto the drop zone, or click Browse to select them.
- Supported formats: PDF, DOCX, PPTX, MP4, JPEG, PNG, and more.
- Review the file list, then click Import Selected Files.
Source 4: AI Skeleton ๐ค
After importing any source, trigger AI analysis to auto-generate course structure.
- Click the AI Skeleton tab.
- Click Generate Skeleton.
- The Co-Professor proposes a full hierarchy in the Action Panel.
- Review, then Approve & Execute or Reject & Modify.
๐ก Google Sites import is not available in the web app. Use the desktop app when you need to ingest content from a Google Sites course site. |
5.1 Import Progress
Figure 8: Import progress dialog โ do not close the window until import completes
A live progress bar and log appear while files are being processed. Wait until the confirmation message appears before closing the wizard.
6. Using the AI Co-Professor Agent
The Co-Professor Agent in the web app is identical to the desktop version โ it can discuss pedagogy, propose course structure, generate lecture notes, and compile semantic summaries. All actions require your explicit approval before execution.
6.1 Conversational Mode
Type any question or request in the Co-Professor chat panel. Examples:
- "What are the most important topics to cover in Fluid Statics?"
- "Review my Module 2 structure and suggest improvements."
- "Are there any missing lessons in Topic 1.1?"
๐ก The Co-Professor reads the current database on every message. Save your latest changes before asking it to review your structure. |
6.2 Creating Nodes via the Agent
- Ask the agent to create nodes: "Add 3 lessons on Bernoulli's equation under Topic 2.1"
- The agent proposes an action plan in the Action Panel.
- Review the proposed structure and click Approve & Execute.
6.3 Generating PDF Lecture Notes
- Type: "Generate notes for Lesson: Introduction to Bernoulli's Principle"
- The agent proposes a note-generation action.
- Click Approve & Execute.
- A PDF is generated, saved on the server, and linked to the lesson automatically.
6.4 Compiling Semantic Summaries
โ ๏ธ Always Compile your course before Publishing. Without compilation, the student AI Tutor has incomplete course context. |
- Click Compile in the toolbar.
- The system processes all lessons, extracts PDF content, and generates AI summaries.
- A progress bar shows compilation status.
- When complete, the course is ready for publishing.
๐ก Smart caching reuses unchanged summaries. Only modified lessons are reprocessed on subsequent compiles. |
7. Cloud Course Browser
Figure 9: Cloud Course Browser in the web app โ browse and download published courses
Click Cloud Browser in the toolbar to browse all published courses on the platform.
- Click any row to select a course.
- Click Download to Workspace to add it to your course library.
- The course appears in your Hierarchy Architect under its own node.
8. Sharing Courses
Share any course you own with other professors using the Share Course option in the right-click context menu on the Course node (identical to the desktop app). See the Professor Desktop Manual ยง7 for full sharing instructions.
9. Saving, Publishing & Cloud Sync
9.1 Saving
- Click Save in the toolbar.
- All current tree state and attachments are saved to the server.
๐ก Web app saves go directly to the cloud โ there is no local file to backup. Save frequently during long editing sessions. |
9.2 Publishing
- Click Publish in the toolbar.
- The system saves your state and begins the upload process.
Figure 10: Publish progress dialog โ live log of file uploads
- A live log shows each file being uploaded. Wait for the success message.
- Click Close when publishing completes.
- Students can now access the updated course immediately.
10. Recommended Workflow
Step | Action | Description |
1 | Log in | Navigate to tutor.academyofknowledge.org and sign in as Professor. |
2 | Open / Create Course | Select an existing course from your dashboard or create a new one. |
3 | Plan Structure | Discuss course goals with the Co-Professor Agent. |
4 | Create / Import | Build hierarchy manually or use the Web Import Wizard. |
5 | Refine | Reorder and reparent nodes using โฌ๏ธโฌ๏ธ and Move To. |
6 | Attach Content | Add videos, PDFs, YouTube links, and Google Docs. |
7 | Generate Notes | Ask the Co-Professor to draft lecture notes for empty lessons. |
8 | Compile | Click Compile to generate AI semantic summaries. |
9 | Publish | Click Publish & Sync to make the course live for students. |
10 | Share | Share with colleagues using the Share Course option. |
Figure 11: Web App course creation workflow โ steps 4 and 5 represent new v3 features
๐ก Keep the web app tab open during a session. Avoid refreshing mid-edit โ Save first to prevent losing uncommitted changes. |
11. Desktop vs Web App โ When to Use Which
Both apps are fully capable. Here is a quick reference:
- Use the web app when: you are on a shared computer, travelling, making quick edits, or have no desktop app installed.
- Use the desktop app when: you need to import from Google Sites, you expect unreliable internet, or you prefer working offline.
- Use either for: all day-to-day course management, Co-Professor conversations, compiling, and publishing.
๐ก Your courses, XP, and settings are fully shared. There is no penalty for switching between apps within a session. |
12. Troubleshooting & FAQ
Q: I cannot see the Import Wizard button.
A: Ensure you are logged in as a Professor (not Student). The Import Wizard is only available in the Professor Creator Interface.
Q: Google Sites import is not available. How do I ingest a Google Sites course?
A: Google Sites import requires the desktop app's embedded browser engine and is not available in the web app. Install the desktop app and use the Import Wizard there.
Q: The Co-Professor Agent is slow to respond.
A: The Co-Professor uses a deep reasoning AI model. Complex structural requests may take 30โ90 seconds. Do not close the browser tab while it is thinking.
Q: Students say they cannot see my changes.
A: Ensure you clicked Publish after your last save. Students sync when they open the course โ they may need to close and reopen it.
Q: Can I undo a Move To operation?
A: Use Move To again to move the node back to its original parent. The change is only permanent after clicking Save.
Q: Compiling seems to take a long time.
A: First-time compilation of a large course can take several minutes. Smart caching speeds up subsequent compiles significantly.
Q: Can I have both the desktop app and web app open at the same time?
A: Yes, but avoid editing the same course in both simultaneously โ the last Save or Publish wins. For best results, work in one at a time.
Q: Are my course files stored on the server?
A: Yes. All course content uploaded via the web app is stored on the AoK AI cloud server (Google Drive). Nothing is stored on your local computer.
Q: The media preview is blank for a video I attached.
A: Check that the video was uploaded successfully. Use the Cloud Browser to verify the file exists in the course folder on Google Drive.
Q: I lost my session (browser crashed or tab closed).
A: Reopen the browser, navigate to tutor.academyofknowledge.org, and sign in. Your last saved state will be restored. Any changes made after the last Save are lost.