T1 Tutor1on1Help

Quick start

Use Tutor1on1 by role.

Teachers publish and manage courses. Students request enrollment, download approved content, and receive personalized guidance, targeted practice, and mistake review.

Install first Teacher flow Student flow Course folder API config ChatGPT OAuth

Teacher flow

Publish and personalize courses.

  1. Log in as a teacher or register a teacher account.
  2. Create or load a local course version.
  3. Upload the validated bundle to the marketplace.
  4. Approve student enrollment requests.
  5. Review each student's progress, recurring mistakes, and synced sessions from the teacher home page.

Student flow

Enroll and study at your pace.

  1. Log in as a student or register a student account.
  2. Open the marketplace and request enrollment in a course.
  3. Wait for teacher approval.
  4. Download the approved course bundle.
  5. Open the course and start a Learn or Review session that follows your progress.

Course creation with AI

Turn PDF, PPT, or teaching notes into a Tutor1on1 course folder.

Use an AI agent to reformat existing teaching materials outside the app. Tutor1on1 then validates, loads, uploads, and lets you refine one KP at a time.

  1. Put the source PDF, PPT, Word files, worksheets, and answer notes into a source folder. If the material is scanned, run OCR first and check formulas manually.
  2. Ask Codex to propose the contents.txt outline first. Approve the KP order, title, and granularity before asking it to write files.
  3. Ask Codex to create the output course folder. Every id in contents.txt must have a matching <id>_lecture.txt. Optional question pools use <id>_easy.txt, <id>_medium.txt, and <id>_hard.txt.
  4. Load the output folder in Tutor1on1 as a teacher. If validation reports a missing file or bad id, paste that error back into Codex and ask it to repair the folder.
  5. After the course loads, use right-click AI edit content on a KP for smaller lesson or question-bank edits.
special_relativity_course/
  contents.txt
  context.txt
  1_lecture.txt
  1.1_lecture.txt
  1.1_easy.txt
  1.1_medium.txt
  1.1_hard.txt

Codex web

  1. Create a new task named Generate Tutor1on1 course folder from teaching materials.
  2. Upload the PDF/PPT/Word files.
  3. Prompt Codex: Read the uploaded materials and propose a Tutor1on1 contents.txt outline. Use dotted ids like 1, 1.1, 1.2. Do not generate files yet. Wait for my approval.
  4. After approving the outline, prompt Codex: Create a complete Tutor1on1 course folder with contents.txt, one <id>_lecture.txt for every id, and optional easy/medium/hard question files. Run a self-check and list missing files.
  5. Download the generated folder or zip, unzip it, and load that folder in Tutor1on1.

Codex desktop or local GUI

  1. Create source_materials/ for the original documents and an empty output folder such as special_relativity_course/.
  2. Open the parent workspace in Codex.
  3. Prompt Codex: Use source_materials/ as input. Create a complete Tutor1on1 course folder in special_relativity_course/. Do not modify source_materials/. First generate contents.txt, then generate all lecture and question files. After writing files, check that every contents.txt id has <id>_lecture.txt.
  4. Let Codex write files directly. Ask it for a final self-check report, then load the output folder in Tutor1on1.

AI edit course inside Tutor1on1

  1. After the folder loads, open the course skill tree as a teacher.
  2. Right-click the target KP node or its title in the list, then choose AI edit content.
  3. Choose Content when you want lesson text, or Question when you want question-bank text for the selected KP.
  4. Chat with the AI until the latest reply is ready to save. Keep each request focused on the current KP.
  5. Click Edit on the AI reply to open the diff window. Review the current text on the left and edit the proposed text on the right.
  6. Choose Add to append or Replace to overwrite. For questions, also choose easy, medium, or hard.
  7. Save the change. Upload the course bundle again when you want marketplace students to receive the updated content.

Personalized learning loop

1

Learn

The tutor explains the next concept in the context of the course and the student's current progress.

2

Practice

Exercises adjust to the student's answers, with hints, simpler examples, and positive feedback when needed.

3

Review mistakes

Meaningful mistakes are summarized into the mistake book so later review targets real weak spots.

API config fields

  • Provider chooses the model service, such as OpenAI or SiliconFlow.
  • Base URL is the provider endpoint used by Tutor1on1. The app shows the URL for the selected provider.
  • API Key is saved locally and used for tutor, TTS, and STT requests when those features need it.
  • Test API key calls {baseUrl}/models, verifies the key, and loads the available text, TTS, and STT model lists. It does not download models or auto-select a new model.
  • Text model powers the tutor conversation. Thinking effort appears only for providers that support reasoning controls.
  • TTS model controls speech output. STT model controls speech-to-text input. They can stay empty if you do not use voice features.
  • Saved API configs store the provider URL, selected models, thinking effort, and a short key hash so you can reuse known-good setups.

Use ChatGPT OAuth instead of an API key

  1. Open Settings, API Settings, and choose OpenAI Codex (ChatGPT OAuth) as the Provider.
  2. Click Login with ChatGPT. Complete the browser login. If the app does not return automatically, paste the final redirect URL or authorization code into the dialog.
  3. Click Refresh models, choose a text model such as gpt-5.5, then save the API config.
  4. Start or reopen a tutor session and choose the saved Codex OAuth model from the model picker.

This option uses ChatGPT/Codex OAuth quota for tutor text calls. TTS and STT still use API-key providers when voice is needed.

Marketplace

Course discovery

Teachers publish course listings. Students browse, request enrollment, and download after approval.

Sessions

Personal feedback

Use Learn for new material and Review for recall practice. Feedback adapts to the student's answer and keeps progress visible.

Sync

Continuity

Teacher and student home pages sync account-linked enrollment, sessions, progress, and mistake-book signals in the background.

Common problems

  • If login or course loading fails, check that the app can reach api.tutor1on1.org.
  • If a student cannot enter a course, confirm that enrollment was approved and the bundle was downloaded.
  • If model lists look stale, run Test API key again for the active provider and key.
  • If progress looks stale across devices, wait for sync to finish or run a manual refresh.