Create Your First Guru

​

What is a Guru?

A Guru is an AI-powered Q&A assistant that can answer questions about any topic based on the sources you provide. Each Guru can process multiple types of content:

• 📄 Websites
• 📑 PDF documents
• 🎥 YouTube videos
• 💻 GitHub repositories

​

Request a New Guru (Gurubase.io)

To get a new Guru for your project:

1. Open an issue with the title “Guru Creation Request”
2. Include:
   • GitHub repository link
   • Whether you are the maintainer
   • If not a maintainer, proof of maintainer’s permission

​

Claim Your Guru (Gurubase.io)

After your Guru is created, you can claim it to manage sources and settings:

1. Open an issue with the title “Guru Claim Request”
2. Provide:
   • Guru link (e.g., https://gurubase.io/g/anteon)
   • Your Gurubase username
   • Proof of maintainership (e.g., merged PR link)

​

Creating a New Guru (Self-hosted)

If you’re using self-hosted Gurubase, you can create Gurus directly:

​

1. Access the Dashboard

From the dashboard, click the “Create New Guru” button.

​

2. Configure Basic Settings

Fill in the following information:

• Guru Name: Choose a descriptive name for your Guru
• Guru Logo: Upload a logo (PNG or JPEG under 1MB)
• Topics: Add comma-separated topics related to this Guru, e.g., “programming, microservices, containers”. This helps the AI understand the Guru’s expertise and context.
• Codebase Indexing: (Optional) Provide a link to a GitHub repository to index its codebase. The Guru can then use this codebase to generate answers based on it.

​

3. Add Knowledge Sources

Your Guru needs sources to learn from. You can add:

1. YouTube Videos: Click “Add YouTube” and paste video URLs
2. Websites: Click “Add Website” and enter webpage URLs
3. PDF Documents: Click “Upload PDFs” to add documentation files

​

4. Publish Your Guru

Click “Publish Guru” to create your assistant. The system will:

1. Process all your sources
2. Generate embeddings
3. Create the knowledge base
4. Make your Guru available for questions

​

Managing Your Guru

After claiming your Guru, you can manage it in several ways:

​

Managing Website Sources

To manage website sources:

1. Click the menu icon (⋮) next to a website source
2. Select “Edit” to open the URLs management dialog
3. Here you can:
   • Search through existing URLs
   • Select and delete specific URLs
   • See when each URL was last indexed
   • Add new URLs to the source

​

PDF Privacy Settings

For PDF documents, you can control their visibility in the references of the answers:

1. Click the menu icon (⋮) next to a PDF source
2. Toggle between “Public” and “Private” status
3. Private PDFs are only accessible to you and your team

​

Reindexing Sources

To update your Guru with the latest content:

1. Click the menu icon (⋮) next to any source
2. Select “Reindex” to fetch and process the latest content
3. The system will:
   • Fetch the latest version of the content
   • Update embeddings
   • Refresh the knowledge base

​

Other Management Options

You can also:

• Update basic information like name and topics
• Generate Widget IDs for website integration
• Monitor source indexing status
• Delete the Guru if needed

​

Using Your Guru

Once your Guru is ready:

1. Navigate to your Guru’s page
2. Type your question in the search box
3. Get AI-powered answers with:
   • Source references
   • Trust score indicators
   • Follow-up suggestions

​

Next Steps