cat docs/getting-started.md
All docs

Getting started

Welcome to Oshu. This guide takes you from an empty workspace to a live chatbot embedded on your site in a few minutes.

1. Create your first agent

An agent is a chatbot with its own personality, knowledge, and appearance.

  1. Open Agents in the sidebar and choose New agent.
  2. Give it a name your visitors will recognise (for example "Support" or "Course assistant").
  3. Write a short system prompt describing how it should behave — its tone, what it helps with, and anything it should never do.
  4. Save. Your agent is created and ready to talk.

2. Give it knowledge (optional but recommended)

By default an agent answers from the model's general knowledge. To ground it in your content — product docs, a course script, policies — attach a library.

  1. Open Libraries, create one, and add sources (upload PDFs or sync a public GitHub repository of Markdown files).
  2. Back on the agent, attach the library.

Now the agent answers from your material and cites where each fact came from. See Libraries and sources.

3. Make it yours

Open the agent's Theme tab to set colours, the window size, the launcher icon, and the welcome message. Everything updates in a live preview. See Theming and embedding.

4. Put it on your site

Open the agent's Embed tab and copy the snippet. Paste it before the closing </body> tag of any page. That's it — the chat launcher appears in the corner.

Prefer a shareable link instead of an embed? Enable the public page on the agent and share its URL or QR code.

Next steps