> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmo.humanizing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Set up Cosmo and deploy your first channel in under 10 minutes

## Welcome to Cosmo by Humanizing

This guide walks you through setting up Cosmo as your AI receptionist. You will create one AI agent, add knowledge, and deploy your first channel. Most teams start with the Chatbot, then add the Voicebot or Receptionist Avatar when they are ready.

<Note>
  **Prerequisites**: You'll need content for Cosmo to learn from, such as web pages, text, or FAQs. If you are starting with the Chatbot, you will also need the website where you want to deploy it.
</Note>

## Quick Start Overview

<Steps>
  <Step title="Create Your Account">
    Sign up for Cosmo by Humanizing and create your first workspace.
  </Step>

  <Step title="Set Up Your AI Agent">
    Go through the guided onboarding to configure your domain, branding, avatar, and knowledge.
  </Step>

  <Step title="Add Knowledge">
    Import your website content, add custom text, or create Q\&A pairs.
  </Step>

  <Step title="Deploy a Channel">
    Turn on the Chatbot, connect the Voicebot, or launch the Receptionist Avatar.
  </Step>
</Steps>

## Step 1: Create Your Account

<Accordion title="Sign up and create a workspace" icon="user-plus">
  1. Go to [app.cosmo.humanizing.com](https://app.cosmo.humanizing.com) and click **Sign Up**
  2. Enter your email address and create a password
  3. Verify your email address by clicking the link we send you
  4. Create your first workspace by entering a name for your team or project

  <Tip>
    Workspaces help you organize agents by project, client, or team. You can create multiple workspaces and invite team members.
  </Tip>
</Accordion>

For detailed authentication options including magic link sign-in and password reset, see [Authentication](/getting-started/authentication).

## Step 2: Set Up Your AI Agent

Once you're logged in, you'll be guided through the setup process:

<AccordionGroup>
  <Accordion title="Enter your website domain" icon="globe">
    Start by entering your website's domain (e.g., `yourdomain.com`). This helps us:

    * Fetch available pages to import as knowledge sources
    * Detect your brand colors and logo automatically
    * Configure Cosmo's identity
  </Accordion>

  <Accordion title="Select pages to import" icon="file-lines">
    We'll discover pages from your website. Select which ones contain content you want Cosmo to know about:

    * Product pages
    * FAQ sections
    * Help documentation
    * About pages

    <Tip>Focus on content that answers common visitor questions. You can always add more sources later.</Tip>
  </Accordion>

  <Accordion title="Choose your avatar" icon="user">
    Select a 3D avatar to represent Cosmo. The avatar:

    * Speaks and animates during conversations
    * Creates a more engaging experience for visitors
    * Can be customized to match your brand
  </Accordion>

  <Accordion title="Wait for content ingestion" icon="spinner">
    Your selected pages will be processed and indexed. This usually takes 1-2 minutes depending on the amount of content.
  </Accordion>
</AccordionGroup>

For complete details on the Chatbot setup flow, see [Chatbot Onboarding](/agents/onboarding).

## Step 3: Add Knowledge Sources

Cosmo learns from three types of knowledge sources:

<CardGroup cols={3}>
  <Card title="Web Sources" icon="globe" href="/sources/web-sources">
    Import content from your website pages, sitemaps, or crawl entire sections.
  </Card>

  <Card title="Text Sources" icon="file-lines" href="/sources/text-sources">
    Add custom text content like product descriptions, policies, or internal documentation.
  </Card>

  <Card title="Q&A Sources" icon="message-question" href="/sources/qa-sources">
    Create specific question-answer pairs for FAQs and common queries.
  </Card>
</CardGroup>

<Note>
  The more relevant content you add, the better Cosmo will be at answering visitor questions. Start with your most frequently asked questions and expand from there.
</Note>

## Step 4: Deploy the Chatbot

Once your AI agent is configured, deploying the Chatbot is simple:

<Steps>
  <Step title="Go to Deployment">
    Navigate to your agent's **Deployment** tab in the Cosmo dashboard.
  </Step>

  <Step title="Copy the embed script">
    Copy the generated script tag:

    ```html theme={null}
    <script
      src="https://chat.humanizing.com/embed.js"
      data-agent-id="your-agent-id"
      async
    ></script>
    ```
  </Step>

  <Step title="Add to your website">
    Paste the script before the closing `</body>` tag on every page where you want the chat widget to appear.
  </Step>

  <Step title="Verify it's working">
    Visit your website and look for the chat widget icon in the corner. Click it to start a conversation!
  </Step>
</Steps>

For complete deployment options and customization, see [Deployment](/agents/deployment).

## Next Steps

Now that your first channel is live, explore these features:

<Columns cols={2}>
  <Card title="Customize Appearance" icon="palette" href="/customization/styling">
    Match Cosmo's look to your brand with colors, backgrounds, and styling options.
  </Card>

  <Card title="Test in Playground" icon="flask" href="/agents/playground">
    Try different prompts and templates to fine-tune Cosmo's responses.
  </Card>

  <Card title="View Conversations" icon="comments" href="/agents/conversations">
    Monitor what visitors are asking and how Cosmo responds.
  </Card>

  <Card title="Analyze Performance" icon="chart-line" href="/agents/analytics">
    Track usage metrics and understand how visitors interact with Cosmo.
  </Card>
</Columns>

## Need Help?

<Card title="Contact Support" icon="envelope" href="mailto:support@humanizing.dev" horizontal>
  Our team is here to help you get the most out of Cosmo by Humanizing. Reach out anytime!
</Card>
