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.
- Description — optional, but instructors see it.
Your new tool opens on its AI Builder page. Every tool is hosted by Voshi; running one on your own server is an exception Voshi considers case by case (see Advanced: External Hosting).
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 it has enough, the wand button becomes Generate Tool; press it. 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 Replace Code puts your edited folder back. Or skip the round trip and let your editor's agent work on the tool directly — see Editor Agents. 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, open the Versions tab and press New Version: Voshi records the draft as version 1. Choose its visibility: private publishes at once, for courses you teach yourself; unlisted or public sends it to Voshi for review. Later publishes make version 2, 3, and so on; courses keep the version they adopted until their instructor chooses to upgrade. See Versions.
Once Voshi approves an unlisted or public version, it is your tool's current version — the one a course gets when an instructor adds your tool. A public version lists the tool in the Voshi catalog, where any instructor can find it. An unlisted one is added with a sharing code from the Sharing tab, which you hand to the instructors you choose. See Sharing your tool.
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.