khoj/documentation/docs/features/chat.md

---
sidebar_position: 2
---

# Chat

You can configure Khoj to chat with you about anything. When relevant, it'll use any notes or documents you shared with it to respond. It acts as an excellent research assistant, search engine, or personal tutor.

<img src="https://assets.khoj.dev/vision_chat_example.png" alt="Chat on Web" style={{width: '400px'}}/>

### Overview
- Creates a personal assistant for you to inquire and engage with your notes or online information as needed
- You can choose to use Online or Offline Chat depending on your requirements
- Supports multi-turn conversations with the relevant notes for context
- Shows reference notes used to generate a response

### Setup (Self-Hosting)
See [the setup guide](/get-started/setup.mdx) to configure your chat models.

### Use
1. Open Khoj Chat
    - **On Web**: Open [/chat](https://app.khoj.dev/chat) in your web browser
    - **On Obsidian**: Search for *Khoj: Chat* in the [Command Palette](https://help.obsidian.md/Plugins/Command+palette)
    - **On Emacs**: Run `M-x khoj <user-query>`
2. Enter your queries to chat with Khoj. Use [slash commands](#commands) and [query filters](/miscellaneous/advanced#query-filters) to change what Khoj uses to respond


#### Details
1. Your query is used to retrieve the most relevant notes, if any, using Khoj search using RAG.
2. These notes, the last few messages and associated metadata is passed to the enabled chat model along with your query to generate a response

#### Conversation File Filters
You can use conversation file filters to limit the notes used in the chat response. To do so, use the left panel in the web UI. Alternatively, you can also use [query filters](/miscellaneous/advanced#query-filters) to limit the notes used in the chat response.

<img src="/img/file_filters_conversation.png" alt="Conversation File Filter" style={{width: '400px'}}/>

#### Commands
Slash commands allows you to change what Khoj uses to respond to your query
- **/notes**: Limit chat to only respond using your notes, not just Khoj's general world knowledge as reference
- **/general**: Limit chat to only respond using Khoj's general world knowledge, not using your notes as reference
- **/default**: Allow chat to respond using your notes or it's general knowledge as reference. It's the default behavior when no slash command is used
- **/online**: Use online information and incorporate it in the prompt to the LLM to send you a response.
- **/image**: Generate an image in response to your query.
- **/help**: Use /help to get all available commands and general information about Khoj
- **/summarize**: Can be used to summarize 1 selected file filter for that conversation. Refer to [File Summarization](summarization) for details.
Migrate to using docusaurus, rather than docsify for documentation (#603) * Add docusaurus documentation (to replace the docsify setup * Remove older docs * Specify documentation as the gh pages build action working directory 2024-01-07 14:58:15 +00:00			`---`
			`sidebar_position: 2`
			`---`

			`# Chat`

Make some basic updates to the chat documentation. Inc. conversation file filters, new screenshot 2024-06-18 06:44:59 +00:00			`You can configure Khoj to chat with you about anything. When relevant, it'll use any notes or documents you shared with it to respond. It acts as an excellent research assistant, search engine, or personal tutor.`

Update the documentation with swanky new demo videos 2024-09-12 02:57:01 +00:00			`<img src="https://assets.khoj.dev/vision_chat_example.png" alt="Chat on Web" style={{width: '400px'}}/>`
Migrate to using docusaurus, rather than docsify for documentation (#603) * Add docusaurus documentation (to replace the docsify setup * Remove older docs * Specify documentation as the gh pages build action working directory 2024-01-07 14:58:15 +00:00
Simplify setup, features since Khoj cloud in docs - No Khoj server setup required to start using Khoj from Obsidian, Emacs - Use tabs for install, upgrade in Emacs with different package managers - Use default subtitles in Khoj Docs - Deduplicate query filters, remove backend setup instructions in plugin pages - Remove stale Setup demo on Khoj Obsidian plugin docs 2023-11-19 01:25:52 +00:00			`### Overview`
Make some basic updates to the chat documentation. Inc. conversation file filters, new screenshot 2024-06-18 06:44:59 +00:00			`- Creates a personal assistant for you to inquire and engage with your notes or online information as needed`
Update docs with setup instructions for Offline and Online Chat 2023-07-29 17:49:40 +00:00			`- You can choose to use Online or Offline Chat depending on your requirements`
📝 Add a documentation base for Khoj! (#333) * Add docs for more organized, accessible information detailing Khoj setup * Delete duplicated files * Add a coverpage without enabling it. Add logo and theme * Remove obsidian README.md * Add plausible script to index.html via docsify 2023-07-21 05:34:25 +00:00			`- Supports multi-turn conversations with the relevant notes for context`
			`- Shows reference notes used to generate a response`
Fix diff blocks, links, remove footnotes & rearrange sections in docs Extract performance into separate sectin into shoving it under search Create page for web interface 2023-07-21 07:05:44 +00:00
Update references to all documentation to reflect instructions for managed service - By default assume the audience of this website is people looking to understand the featuer offering of Khoj, and then people who are looking to self-host 2023-11-16 23:26:03 +00:00			`### Setup (Self-Hosting)`
Update the documentation with swanky new demo videos 2024-09-12 02:57:01 +00:00			`See [the setup guide](/get-started/setup.mdx) to configure your chat models.`
Update docs with setup instructions for Offline and Online Chat 2023-07-29 17:49:40 +00:00
			`### Use`
Document slash command and query filter in docs for chat and search 2023-08-28 17:43:17 +00:00			`1. Open Khoj Chat`
Update references to all documentation to reflect instructions for managed service - By default assume the audience of this website is people looking to understand the featuer offering of Khoj, and then people who are looking to self-host 2023-11-16 23:26:03 +00:00			`- On Web: Open [/chat](https://app.khoj.dev/chat) in your web browser`
Document slash command and query filter in docs for chat and search 2023-08-28 17:43:17 +00:00			`- On Obsidian: Search for Khoj: Chat in the [Command Palette](https://help.obsidian.md/Plugins/Command+palette)`
			- On Emacs: Run `M-x khoj <user-query>`
Make the docs overview page as the main docs landing page - Make the docs overview page available at docs.khoj.dev root instead of under docs.khoj.dev/docs path - Remove the new landing page, it is unnecessary. - Remove /docs path prefix from links to internal doc pages - Remove .md path suffix in internal doc pages for consistency 2024-01-07 19:02:23 +00:00			`2. Enter your queries to chat with Khoj. Use [slash commands](#commands) and [query filters](/miscellaneous/advanced#query-filters) to change what Khoj uses to respond`
📝 Add a documentation base for Khoj! (#333) * Add docs for more organized, accessible information detailing Khoj setup * Delete duplicated files * Add a coverpage without enabling it. Add logo and theme * Remove obsidian README.md * Add plausible script to index.html via docsify 2023-07-21 05:34:25 +00:00

Update docs with setup instructions for Offline and Online Chat 2023-07-29 17:49:40 +00:00			`#### Details`
Update the documentation with swanky new demo videos 2024-09-12 02:57:01 +00:00			`1. Your query is used to retrieve the most relevant notes, if any, using Khoj search using RAG.`
Update docs with setup instructions for Offline and Online Chat 2023-07-29 17:49:40 +00:00			`2. These notes, the last few messages and associated metadata is passed to the enabled chat model along with your query to generate a response`
Document slash command and query filter in docs for chat and search 2023-08-28 17:43:17 +00:00
Make some basic updates to the chat documentation. Inc. conversation file filters, new screenshot 2024-06-18 06:44:59 +00:00			`#### Conversation File Filters`
			`You can use conversation file filters to limit the notes used in the chat response. To do so, use the left panel in the web UI. Alternatively, you can also use [query filters](/miscellaneous/advanced#query-filters) to limit the notes used in the chat response.`

Update the documentation with swanky new demo videos 2024-09-12 02:57:01 +00:00			`<img src="/img/file_filters_conversation.png" alt="Conversation File Filter" style={{width: '400px'}}/>`
Make some basic updates to the chat documentation. Inc. conversation file filters, new screenshot 2024-06-18 06:44:59 +00:00
Document slash command and query filter in docs for chat and search 2023-08-28 17:43:17 +00:00			`#### Commands`
			`Slash commands allows you to change what Khoj uses to respond to your query`
			`- /notes: Limit chat to only respond using your notes, not just Khoj's general world knowledge as reference`
			`- /general: Limit chat to only respond using Khoj's general world knowledge, not using your notes as reference`
			`- /default: Allow chat to respond using your notes or it's general knowledge as reference. It's the default behavior when no slash command is used`
Migrate to using docusaurus, rather than docsify for documentation (#603) * Add docusaurus documentation (to replace the docsify setup * Remove older docs * Specify documentation as the gh pages build action working directory 2024-01-07 14:58:15 +00:00			`- /online: Use online information and incorporate it in the prompt to the LLM to send you a response.`
			`- /image: Generate an image in response to your query.`
Document slash command and query filter in docs for chat and search 2023-08-28 17:43:17 +00:00			`- /help: Use /help to get all available commands and general information about Khoj`
Add Documentation for the /summarize Command (#822) * added documentation for the /summarize command * Add a hint for natural language usage --------- Co-authored-by: sabaimran <narmiabas@gmail.com> 2024-06-20 06:38:01 +00:00			`- /summarize: Can be used to summarize 1 selected file filter for that conversation. Refer to [File Summarization](summarization) for details.`