Quickstart
This walkthrough takes you from nothing to a tool that instructors can place in a course. You will not write a server, configure a web host, or handle a login — Voshi does all of that. What you write (or have the AI write) is the tool itself.
What you'll need
- A Voshi builder account — contact the MyEducator team if you don't have dashboard access yet.
- An idea of what the learner should be doing. That is the whole brief.
Open the Voshi dashboard, go to Tools → New Tool, and fill in:
- Tool Name — shown to instructors when they add your tool to a course.
- Hosting — leave it on Voshi Hosted. This is the choice these docs describe, and it cannot be changed later. (Self Hosted means you run your own server; see Advanced: your own server.)
- Description — optional, but instructors see it.
Your new tool opens on its AI Builder page.
In the Discuss Design panel, say what the learner should be learning or doing. Write it the way you would explain it to a colleague:
A flashcard drill for ten accounting terms. The student flips each card, marks whether they knew it, and sees a score at the end. The score goes to the gradebook.
The AI replies with questions or with a plan. Answer what matters to you; it fills in the rest. When you are ready, press the build button (the wand). Building takes a few minutes.
When the build finishes, the Running Tool panel on the right launches your tool for real, in your tool's private Sandbox course. Pick a location and a role — student or instructor — and use the tool exactly as a learner would.
This is not a preview. The tool is saving data, checking roles, and reporting scores against a real course, so what works here works in a school's LMS.
Keep talking in the chat. "Make the cards bigger." "Add a timer." "Let the instructor change the terms." Each build replaces your tool's draft, and the Running Tool panel reloads it.
You can also take the code elsewhere: Download Code gives you the folder, including an AGENTS.md that briefs your own coding assistant on the rules, and Upload Code puts your edited folder back. See Your tool's files.
A location is one thing an instructor can put in a course. A one-activity tool has one location, called home, and the AI Builder creates it for you. Open the Locations tab to see what your tool offers, and to add more if your tool has several activities — one per graded thing, one per distinct thing a student can open. See Locations.
Only an assessment location can report a grade. Check its points: that becomes the gradebook column's value when an instructor places it.
The Sandbox tab is the course your tool has been running in. Its Links tab lets you place your locations the way an instructor would, through the same picker they see. Launch each link as a student and as an instructor, then check the Sandbox's Launches and Grades tabs to see what Voshi recorded. See Testing in the Sandbox.
The Sandbox runs your draft — whatever you built or uploaded last. Courses never run the draft. When the tool is ready, publish it: Voshi records the draft as version 1, and that is the version a course gets when an instructor adds your tool. Later publishes make version 2, 3, and so on; courses keep the version they adopted until their instructor chooses to upgrade. See Versions.
Your tool starts in draft status, which means instructors cannot see it yet. Once it works in the Sandbox and you have published a version, contact the MyEducator team to activate your tool. After activation, instructors can add it to their courses.
Where to next
What your code is, what Voshi does for it, and the rules it lives by.
Launch details, storage, files, and grades — everything your tool can ask Voshi for.
What is in the folder, what manifest.json does, and how to edit the code yourself.
Draft, published versions, and how courses adopt them.