for hosts · the guide

Hosting, answered.

Everything you need to bring a voice to life and grow it — content, publishing, community, privacy, and cost. No technical knowledge required.

getting started

From zero to your first answer.

First Step to Create Your Bot

To get started, the first thing you need to do is gather some content that you want your bot to understand.

  • If you're the content creator: Gather your YouTube videos, blog posts, books—anything you've made that you want your bot to share. Your bot needs content and resources to generate great answers.

  • If you're not the creator: You'll need permission from the person who made the content. Once you've got the creator's permission, you're good to go.

The second step is to create a "credo" -- this is like a fundamental constitution of your identity. A bit like a one-pager around your core values. We've already started you out with a default credo, but you can customize it however you'd like once you have access to your bot's settings.

Hello world. Your First Query!

Setting up your Bot doesn't take any technical knowledge. Here's a simple way to get started:

  • Upload one or more documents through your Bot's upload page.

  • Track the status of that document from the 'Received' to 'Accepted' to 'Processed'. It can take up to two hours to be processed.

  • Go to your bot's page and ask a question specific to something in your document -- and watch the response!

And you're off to the races. (Tip: if your document is small and not very specific, you will want to remove all other data sources so your data isn't crowded out.)

Once you have this going, next step is to expand your bot's repertoire -- by adding more data, refining your credo, and customizing some of the settings.

feeding content

What your voice learns from.

Who's in Charge of What My Bot Knows?

You are! You decide what is uploaded to inform your bot's wisdom library. Need help? Drop us a note. We can also connect you to power-users like Rick Archer who has pioneered the BatGapBot and is happy to guide you through individual consultation.

I've Written Books, Can I Upload PDFs for My Bot?

Yes, you can! Feeding your bot PDFs is similar to giving it a library to read from. Questions about copyright? We have good news—as of 2023, it's generally okay for bots like yours to learn from copyrighted content without needing extra permission (this is called "fair use"). Your bot isn't rewriting your books—it's just chatting about them. If you still have concerns, please review this article for a deeper dive into copyright and AI.

You control what users see when you upload files by adjusting the visibility settings:

  • Keep it hidden: The bot uses it to answer but doesn't show the file.
  • Add a link: Point users to your website or Amazon page instead.

Example: If your bot quotes your book, it could say, "Learn more on page 45—check it out here."

How Do I Add My YouTube Videos?

Turning your videos into bot-ready content is easier than you may think. Here's a breakdown of the process:

  1. Download your videos: Use a tool like MediaHuman YouTube Downloader—just copy, paste, and click to grab your audio files. Various bot owners have cited this as a simple process.
  2. Turn audio into text: Run those files through WhisperAI (we recommend Whisperer—it's user-friendly and can handle tons of files at once). It'll create transcripts your bot can use.

Note that Whisper can transcribe a lot of languages, keeping the text in those languages or translating it to English (a Chinese developer tool like 讯飞 may perform better in the Chinese language than Whisper).

  1. Feed it to your bot: Upload those transcripts via your bot's upload page. Now it's ready to chat about your videos!
  2. Example: BatGap Bot uses this to make interviews bot-friendly.
Can My Bot Offer Time Coded Video Source Links?

This is currently a work in progress. We're working on a way to add time-coded links (like "Watch this at 2:15") to its answers.

For the time being, follow the instructions in this doc on how to make spreadsheets of YouTube video file names and URLs so that the bot can offer time coded video source links. Feel free to skip this section if it's not a priority for you at this time.

For more details on YouTube video processes, check out this document. It covers adding time codes, creating Chapters, and incorporating multi-language translations and dubbing.

Can My Bot Connect With Others, Like Batgap Bot or Compassion Bot?

That's up to you! Your bot can share its info with other bots in the Compassion Bot network—or borrow from them. For instance:

  • BatGap Bot links to other bots because spiritual topics overlap.
  • Some owners prefer a solo act, keeping their bot focused on their own content. Either way works, and it's your choice.
How Does My Bot Actually Use My Content? (The Technical Part)

When you upload content, here's what happens behind the scenes:

Your documents are processed using a RAG (Retrieval-Augmented Generation) system. In simple terms:

  1. Storage: Your content is indexed in our Elastic Search database, which helps find relevant passages quickly
  2. Matching: When someone asks a question, we find the most relevant sections from your content
  3. Response: Those relevant sections are sent to an LLM (like OpenAI, Claude, or others you choose) along with the question to generate a thoughtful answer
  4. Attribution: Based on your visibility settings, we either cite sources, provide links, or keep sources private

Think of it like having a smart librarian who knows exactly which pages of your books to reference when answering questions.

What Format Should My PDFs Be In?

Keep it simple:

  • No password protection - Your PDFs need to be unlocked so our system can read them
  • Standard PDF format - Most PDFs work great, whether they're books, articles, or transcripts
  • Any language - Our system handles multiple languages, though English performs best
publishing

Going public, on your terms.

When Can My Bot Go Live?

It's all up to you—no pressure! There's no "not enough content" rule. Even one video or blog post is enough to start.

  • How to do it: Visit your bot's Advanced Settings, check the "Make Public" box, and save changes.
  • Quick Tip: Test it with a friend first—get their feedback before making it public
Public vs. Private Bots: What's the Difference?

If a bot is private, only those granted specific access can see it. For public bots, you can choose to share its data corpus with other bots in the network, which most bot owners do.

Batgap Bot integrates other data due to its relevance. However, some bot owners prefer their bots to focus solely on their own content. While they may share their data with others, they do not incorporate external data into their bots.

Please note: Making your bot public is different from making your content public. If your bot is public, anyone who registers on the website can use it. However, access to the content that informs the bot depends on the visibility settings you choose when uploading it.

Public Visibility: Anyone on the web can chat with your bot if they register. You decide if they see your content (e.g., PDFs or transcripts) or just get answers.

Why Share Your Bot Publicly?

The Benefits

One of the biggest advantages of sharing content publicly is increased discoverability. By making your content more accessible—through bite-sized bot responses—you expand its reach. This can serve as an effective marketing tool, bringing more traffic and revenue to your core content offerings without cannibalizing your existing revenue streams.

For independent content creators with limited marketing resources, platforms like Awakin provide a way to gain visibility. Even well-established teachers, such as Sharon Salzberg and Richard Lang (Headless Way), have set up bots to share their wisdom and practices, demonstrating that strategic content sharing can benefit both emerging and prominent voices alike.

If you operate on a gift economy model, there's even more reason to consider an Awakin bot, as it allows you to reach a highly targeted audience while maintaining the integrity of your approach.

Addressing Potential Concerns

When sharing content, privacy and control are key considerations. There are flexible ways to manage this:

  • Private Content for Informing the Bot — Content can be uploaded privately so that it informs the bot's answers without being directly visible to users.
  • Public Content for Direct Access — Content can be made publicly available, allowing users to view or download it. However, for certain materials (e.g., books), you may prefer to restrict direct access.
  • Link-Based Access — Instead of sharing full content, you can provide links directing users to your website, an Amazon page, or other platforms.
  • Video Transcripts — If a transcript is used to generate a bot response, we can include a video source link at the bottom, directing users to the exact point in the video. Alternatively, if you prefer to keep videos private, transcripts can be used internally to inform answers without displaying the source or transcript itself.

By carefully selecting how your content is shared, you can maximize its impact while maintaining control over accessibility and monetization.

How Do I Rename My Bot?

If your bot's name defaults to yours (e.g., "SharonBot") but you'd rather honor someone else—like the content creator—here's how:

  1. Go to your Bot Settings
  2. Change the name of your Bot under the "Configure" tab, where it says "Bot Name". Click "Save Changes" at the bottom of the screen.
growing community

Sharing your voice.

How Do I Build and Engage My Community?

Think of your bot as a friendly guide who connects you with people who love your work. Here's how to get the word out:

  • Start with your fans: Share your bot with friends, followers, or email subscribers. Invite them to ask it questions and see what they think.
  • Example: Rick Archer (BatGapBot) shares his bot with his Buddha at the Gas Pump audience—it's a natural fit.
  • Get creative: Host a "Bot Q&A Day" on social media, where folks can try it live. Or ask your community to suggest questions—let them help shape it!
  • Learn as you go: Check out this page for Rick's tips on growing BatGapBot's community. Tried something different? Tell us—we'd love to hear your experiences!
  • Quick Tip: Don't wait for perfection—start small and watch your community grow with your bot.
Where Can I Share My Bot's Wisdom?

Your bot's insights can be shared across multiple platforms, expanding its reach and engagement. Here are some key places to showcase its wisdom:

  • Your Website — Embed your bot or provide a direct link, allowing visitors to interact with it anytime—like having a 24/7 guide on your site.
  • Social Media — Share compelling bot responses to thought-provoking questions (e.g., "What's your take on mindfulness?") and encourage followers to engage with it directly.
  • Email & Newsletters — Feature a snippet of a bot-generated response with a call-to-action, inviting readers to explore further.
  • Other Platforms — Share your bot's insights on forums, blogs, or even at in-person events—wherever your audience is most active.

Quick Tip: Enhance engagement by pairing a bot-generated response with a link to your YouTube video, book, or other content, driving traffic while providing valuable insights.

Why Share Your Bot?

Spreading your bot's voice helps your community access the totality of your content, via a simple and interactive interface of a chatbot. The increased usage also allows more derivatives to emerge, like handbooks in different languages or a book of quotes for Gen Z to access your content and more.

Bot Hosts also frequently report that as they get more interactions with their bots, the source links drive more engagement to their books, websites and online engagement platforms.

Can I Embed My Bot on My Own Website?

Yes! While we don't offer direct API access yet, you can:

  • Embed the chat interface on your website using an iframe (we have examples to help you)
  • Coming soon: MCP (Model Context Protocol) integration for more advanced setups
  • Current examples: Several bot owners have successfully embedded their bots, like: Suzanne Giesemann and BatGap Bot

For implementation details, please contact us.

Can I Add New Content To My Bot Automatically?

Yes! If you have a regular blog or content updates, you can simply provide an RSS feed to our Tech Team, and we'll check for daily updates and add new content to your bot.

Do Users Need To Be Logged In To Access My Bot?

By default, users need to be logged in to Awakin.ai to access your bot. This is primarily done as a safeguard to prevent abuse for computing resources. (Note: creating a new account is as simple as two clicks.)

For more visible bots with larger reach, we do offer an option to give web users limited access to your bot without having an Awakin.ai account. To explore this option, please drop us a note.

security & privacy

Your content, protected.

Who Can Access My Uploaded Content?

We take your content security seriously. Files are stored on secure AWS servers with encryption, and we never share, sell, or use your content for any purpose other than powering your bot.

Backend Access:

  • Members with 'Host' access to your Bot, that is assigned by you
  • Senior ServiceSpace technical administrators (2-3 people), that monitor site functionality

Frontend Visibility - You Control What Users See:

Your visibility settings determine exactly what users can access:

  1. "Private" - Bot uses your content to answer but never shows the source or provides downloads
  2. "Custom Link" - Shows brief extracts (under 500 characters) with a link you specify (like Amazon or your website)
  3. "Public" - Allows full content access with proper attribution
Can I Change Privacy of My Uploaded Content?

Yes, you can visit your bot's Uploads page, click on the 'Edit' icon for any document and adjust the 'Visibility' setting.

If you'd like to globally turn off all citations for all responses, you can also do that by visiting your bot's advanced settings and unchecking the 'Cite sources used to construct responses' option.

How Do I Set Up Purchase Links for My Books?

When uploading content you want to monetize:

  1. Set visibility to "Private" or "Link Only"
  2. In the "External Link" field, add your Amazon page, website, or store URL
  3. The bot will show brief excerpts and direct users to your link for the full content

Example: "One paragraph excerpt from your book. View Source [your-amazon-link]."

What About Copyright and Extract Lengths?

We're careful about copyright compliance:

  • Extract length: Limited to 500 characters (about 2-3 sentences) when showing sources
  • Fair use: Our system is designed to stay within fair use guidelines
  • Your control: You can make extracts even shorter or disable them entirely
  • No accidental downloads: Private content cannot be downloaded by users, period.
Is There Any Risk of My Full Book Being Downloaded?

No. Here's why:

  • Files marked "Private" are never accessible for download
  • Our system only sends relevant excerpts to the LLM, not entire books
  • Download links only appear if YOU explicitly set content as "Public"
  • We have multiple safeguards to prevent unauthorized access
Where Exactly Is My Data Stored?

Your content is stored on:

  • ServiceSpace AWS servers (Amazon Web Services)
  • Location: Secure U.S.-based data centers
  • Encryption: Both in transit and at rest
  • Backups: Regular backups ensure your content is safe
  • Access: Limited to 2-3 senior technical volunteers who maintain the platform
  • Our commitment: We're a non-profit with no incentive to misuse data - our mission is to serve you and spread wisdom
costs

What it costs — almost nothing.

Is there a cost to any of this?

No—it's free! Your Bot is a gift from the Awakin AI community and our dedicated team of volunteers.

Building something this sophisticated would typically cost in the seven figures, but it is offered to you as a gift, in appreciation for your thoughtful service to the world.

How can I pay it forward?

If you are in a position to cover the costs of your own Bot's queries, you can create your own "OpenAI" API Key and enter it in the Advanced Settings section of your Bot's settings.

To pay it forward, you can volunteer your time, donate, or just do an act of kindness for the world. In this giant web of interconnections, we trust that what goes around comes around. :)

your move

Ready to begin?

Propose a voice and our volunteers will help you shape it — or open your dashboard if you’re already hosting.