Docs
Browse the docs
Docs / Getting Started

Getting Started

Create your first sidekick, talk to it, and know where to go next. Plan on about five minutes. You can change every choice you make here later.

Finding your way around

After you sign in you land on Sidekicks. On the left is a column of your sidekicks; the rest of the screen is a live chat with whichever one is selected. The admin sidebar on the far left takes you everywhere else. Hover over it to see the labels.

The Sidekicks page with the admin sidebar, a column of sidekick avatars and an empty chat panel
The Sidekicks page. The starred avatar is your Lead Sidekick, the one that opens first.
Sidebar itemWhat you do there
SidekicksChat with your sidekicks. Switch to Grid View to edit, preview, copy embed code or delete them.
Create SidekickOpen the creation wizard. If your plan's sidekick limit is reached, it shows a lock and offers an upgrade instead.
UsersInvite teammates as admins, or add subscribers who can only chat.
Knowledge BaseUpload documents and crawl websites your sidekicks can read. See Knowledge Base.
LoreYour personal context, which helps sidekicks understand you. See Lore & Memory.
Scheduled TasksReminders, briefs and abilities that run on a schedule. See Scheduled Tasks.
AbilitiesThe catalog of things a sidekick can do. See Abilities.
MonitoringThis month's usage and recent activity. See Monitoring.
DocsYou're here.
Your name (bottom)Profile Settings: your details, Telegram link, billing and password.

If your account is on a free trial, the bottom of the sidebar also shows a small usage meter. Click it to see your plan and what's left this month.

Create your first sidekick

Click Create Sidekick in the sidebar. The first screen asks how you'd like to build it:

  • Talk with Farah (recommended). Farah, our own sidekick, asks you the questions out loud and fills in the form from your answers. Your browser will ask for microphone access.
  • Continue without voice. Fill in the same steps yourself.
Create Your Sidekick, step 1 of 9, offering Talk with Farah or Continue without voice
Choose to build your sidekick by conversation, or fill in the form yourself.

Either way, you go through nine short steps. Each step is labelled with the part of the sidekick it shapes (Identity, Spirit, Body, Mind), matching the tabs you'll use later to fine-tune it.

1

Identity: name it

Type a name, or press Randomize Name. The address shown underneath is the sidekick's slug, which becomes part of its embed link.

2

Spirit: describe its personality

A sentence or two about how it should talk and behave is enough, e.g. "Warm and patient, explains things simply, asks a clarifying question when a request is vague." Open Advanced: Personality Traits to fine-tune five sliders, from Practical to Creative and from Reserved to Outgoing.

3

Body: choose a voice

Pick a preset voice (click one to hear a sample), record yourself under My Voice and press Clone Voice, or upload a 5–10 second clip with Upload Voice Sample.

4

Body: give it a face

Describe a look and generate an avatar (this takes 30–90 seconds, so stay on the page). You can then describe changes to refine it, upload your own image, or skip and use a default.

5

Abilities: pick its skills

Switch on the built-in abilities you want, such as web search or article writing. Some abilities need an API key; you'll be asked for those in step 8. You can change abilities at any time.

6

Mind: give it knowledge

Drop in PDF, DOC, DOCX, TXT or MD files (up to 100 MB, within your plan's limits), or paste a website address and press Add Site. This step is optional, and you can add knowledge later.

7

Mind: choose a configuration

Recommended picks a tested combination of speech, voice, language model and search settings, so most people should choose it. Advanced lets you choose each provider yourself.

8

API keys

If your account uses Sidekick Forge Inference, there's nothing to enter and this step just confirms which services are included. If you bring your own keys, paste them here. Keys are encrypted, and you can change them later under API Keys.

9

Launch

Review the summary and press Create Sidekick. A few seconds later it's live and ready to talk.

Don't overthink the first pass. Everything the wizard sets can be changed on the sidekick's configuration page. Get a sidekick live, talk to it, then refine it.

Talk to your sidekick

Go to Sidekicks and select your new sidekick. The buttons at the top left of the chat switch between modes:

  • Text: type and read, like any chat.
  • Voice: a spoken conversation. Allow microphone access when your browser asks.
  • Video: a conversation with an animated avatar. Available on the Champion plan and up, once an avatar provider is set on the Body tab.

New Conversation starts fresh, and the expand icon makes the chat fullscreen.

A text conversation in which the user asks Farah what she can help with and she answers in two sentences, with a source link underneath
When an answer draws on your knowledge base, the sources appear underneath it.

Try asking it about something in a document you uploaded. If the answer cites the document, your knowledge base is working.

Sidekick Forge Inference or your own keys

A sidekick uses several AI services at once: a language model to think, a voice to speak, speech recognition to hear, and an embedding model to search your documents. You can get these two ways, and you can mix them service by service:

Sidekick Forge Inference

We provide the services. Nothing to sign up for, and usage counts toward your plan. This is the easiest way to start.

Bring your own keys

Paste your own key for a provider (for example Cerebras, ElevenLabs or Deepgram). That service is billed to you directly, and you choose exactly which models and voices to use.

You can switch any single service between the two at any time. See API Keys.

Your first-day checklist

  1. Write its soul. On the Spirit tab, describe who your sidekick is and how it speaks. This has the biggest effect on how it sounds.
  2. Feed it knowledge. Upload your FAQs, product sheets and policies on the Knowledge Base.
  3. Choose its abilities. Switch on what it should be able to do on the Abilities tab.
  4. Decide who can reach it. Turn guest chat on or off, then copy the embed code. See Embedding & Channels.
  5. Optional: let it work for you. Connect your inbox under Senses, or ask it for a morning brief with Scheduled Tasks.