Update Screenshots and Demos in Docs
|
Before Width: | Height: | Size: 979 KiB |
|
Before Width: | Height: | Size: 302 KiB After Width: | Height: | Size: 302 KiB |
BIN
docs/assets/khoj_chat_on_obsidian.png
Normal file
|
After Width: | Height: | Size: 394 KiB |
|
Before Width: | Height: | Size: 277 KiB |
BIN
docs/assets/khoj_chat_on_web.png
Normal file
|
After Width: | Height: | Size: 358 KiB |
|
Before Width: | Height: | Size: 126 KiB |
|
Before Width: | Height: | Size: 1.1 MiB |
|
Before Width: | Height: | Size: 378 KiB |
BIN
docs/assets/khoj_search_on_emacs.png
Normal file
|
After Width: | Height: | Size: 420 KiB |
BIN
docs/assets/khoj_search_on_obsidian.png
Normal file
|
After Width: | Height: | Size: 478 KiB |
BIN
docs/assets/khoj_search_on_web.png
Normal file
|
After Width: | Height: | Size: 268 KiB |
@@ -28,7 +28,7 @@
|
|||||||
2. Type your queries and see response by Khoj from your notes
|
2. Type your queries and see response by Khoj from your notes
|
||||||
|
|
||||||
#### Demo
|
#### Demo
|
||||||

|

|
||||||
|
|
||||||
### Details
|
### Details
|
||||||
1. Your query is used to retrieve the most relevant notes, if any, using Khoj search
|
1. Your query is used to retrieve the most relevant notes, if any, using Khoj search
|
||||||
|
|||||||
@@ -1,13 +1,24 @@
|
|||||||
## Demos
|
## Demos
|
||||||
|
|
||||||
### Interfaces
|
### Screenshots
|
||||||
|
#### Web
|
||||||
|

|
||||||
|

|
||||||
|
|
||||||

|
#### Obsidian
|
||||||
|

|
||||||
|

|
||||||
|
|
||||||
### Khoj in Obsidian
|
#### Emacs
|
||||||
|

|
||||||
|

|
||||||
|
|
||||||
|
|
||||||
|
### Videos
|
||||||
|
#### Khoj in Obsidian
|
||||||
[KhojObsidian](https://github-production-user-asset-6210df.s3.amazonaws.com/6413477/240061700-3e33d8ea-25bb-46c8-a3bf-c92f78d0f56b.mp4 ':include :type=mp4')
|
[KhojObsidian](https://github-production-user-asset-6210df.s3.amazonaws.com/6413477/240061700-3e33d8ea-25bb-46c8-a3bf-c92f78d0f56b.mp4 ':include :type=mp4')
|
||||||
|
|
||||||
#### Installation
|
##### Installation
|
||||||
|
|
||||||
1. Install Khoj via `pip` and start Khoj backend in a terminal (Run `khoj`)
|
1. Install Khoj via `pip` and start Khoj backend in a terminal (Run `khoj`)
|
||||||
```bash
|
```bash
|
||||||
@@ -21,10 +32,10 @@
|
|||||||
- Search \"*Announce plugin to folks*\" in the [Obsidian Plugin docs](https://marcus.se.net/obsidian-plugin-docs/)
|
- Search \"*Announce plugin to folks*\" in the [Obsidian Plugin docs](https://marcus.se.net/obsidian-plugin-docs/)
|
||||||
- Jump to the [search result](https://marcus.se.net/obsidian-plugin-docs/publishing/submit-your-plugin)
|
- Jump to the [search result](https://marcus.se.net/obsidian-plugin-docs/publishing/submit-your-plugin)
|
||||||
|
|
||||||
### Khoj in Emacs, Browser
|
#### Khoj in Emacs, Browser
|
||||||
[KhojEmacs](https://user-images.githubusercontent.com/6413477/184735169-92c78bf1-d827-4663-9087-a1ea194b8f4b.mp4 ':include :type=mp4')
|
[KhojEmacs](https://user-images.githubusercontent.com/6413477/184735169-92c78bf1-d827-4663-9087-a1ea194b8f4b.mp4 ':include :type=mp4')
|
||||||
|
|
||||||
#### Installation
|
##### Installation
|
||||||
|
|
||||||
- Install Khoj via pip
|
- Install Khoj via pip
|
||||||
- Start Khoj app
|
- Start Khoj app
|
||||||
@@ -32,7 +43,7 @@
|
|||||||
- Search \"*Setup editor*\" on the Web and Emacs. Re-rank the results for better accuracy
|
- Search \"*Setup editor*\" on the Web and Emacs. Re-rank the results for better accuracy
|
||||||
- Top result is what we are looking for, the [section to Install Khoj.el on Emacs](https://github.com/khoj-ai/khoj/tree/master/src/interface/emacs#2-Install-Khojel)
|
- Top result is what we are looking for, the [section to Install Khoj.el on Emacs](https://github.com/khoj-ai/khoj/tree/master/src/interface/emacs#2-Install-Khojel)
|
||||||
|
|
||||||
#### Analysis
|
##### Analysis
|
||||||
|
|
||||||
- The results do not have any words used in the query
|
- The results do not have any words used in the query
|
||||||
- *Based on the top result it seems the re-ranking model understands that Emacs is an editor?*
|
- *Based on the top result it seems the re-ranking model understands that Emacs is an editor?*
|
||||||
|
|||||||
@@ -112,3 +112,18 @@ Follow the steps below to [release](https://github.com/debanjum/khoj/releases/)
|
|||||||
*[Interactive Visualization](https://mango-dune-07a8b7110.1.azurestaticapps.net/?repo=debanjum%2Fkhoj)*
|
*[Interactive Visualization](https://mango-dune-07a8b7110.1.azurestaticapps.net/?repo=debanjum%2Fkhoj)*
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
## Visualize Khoj Obsidian Plugin Codebase
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## Khoj Obsidian Plugin Implementation
|
||||||
|
The plugin implements the following functionality to search your notes with Khoj:
|
||||||
|
- [X] Open the Khoj search modal via left ribbon icon or the *Khoj: Search* command
|
||||||
|
- [X] Render results as Markdown preview to improve readability
|
||||||
|
- [X] Configure Khoj via the plugin setting tab on the settings page
|
||||||
|
- Set Obsidian Vault to Index with Khoj. Defaults to all markdown, PDF files in current Vault
|
||||||
|
- Set URL of Khoj backend
|
||||||
|
- Set Number of Search Results to show in Search Modal
|
||||||
|
- [X] Allow reranking of result to improve search quality
|
||||||
|
- [X] Allow Finding notes similar to current note being viewed
|
||||||
|
|||||||
@@ -12,6 +12,10 @@
|
|||||||
- **Iterative discovery**: Iteratively explore and (re-)discover your notes
|
- **Iterative discovery**: Iteratively explore and (re-)discover your notes
|
||||||
- **Assisted creativity**: Smoothly weave across answers retrieval and content generation
|
- **Assisted creativity**: Smoothly weave across answers retrieval and content generation
|
||||||
|
|
||||||
|
## Interface
|
||||||
|

|
||||||
|

|
||||||
|
|
||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
- *Make sure [python](https://realpython.com/installing-python/) and [pip](https://pip.pypa.io/en/stable/installation/) are installed on your machine*
|
- *Make sure [python](https://realpython.com/installing-python/) and [pip](https://pip.pypa.io/en/stable/installation/) are installed on your machine*
|
||||||
@@ -104,12 +108,6 @@ To see other notes similar to the current one, run *Khoj: Find Similar Notes* fr
|
|||||||
- Search \"*Announce plugin to folks*\" in the [Obsidian Plugin docs](https://marcus.se.net/obsidian-plugin-docs/)
|
- Search \"*Announce plugin to folks*\" in the [Obsidian Plugin docs](https://marcus.se.net/obsidian-plugin-docs/)
|
||||||
- Jump to the [search result](https://marcus.se.net/obsidian-plugin-docs/publishing/submit-your-plugin)
|
- Jump to the [search result](https://marcus.se.net/obsidian-plugin-docs/publishing/submit-your-plugin)
|
||||||
|
|
||||||
## Interfaces
|
|
||||||
### Search Modal
|
|
||||||

|
|
||||||
|
|
||||||
### Chat Modal
|
|
||||||

|
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
- Open the Khoj plugin settings pane, to configure Khoj
|
- Open the Khoj plugin settings pane, to configure Khoj
|
||||||
@@ -119,18 +117,3 @@ To see other notes similar to the current one, run *Khoj: Find Similar Notes* fr
|
|||||||
## Current Limitations
|
## Current Limitations
|
||||||
- The plugin loads the index of only one vault at a time.<br/>
|
- The plugin loads the index of only one vault at a time.<br/>
|
||||||
So notes across multiple vaults **cannot** be searched at the same time
|
So notes across multiple vaults **cannot** be searched at the same time
|
||||||
|
|
||||||
## Visualize Codebase
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
## Implementation
|
|
||||||
The plugin implements the following functionality to search your notes with Khoj:
|
|
||||||
- [X] Open the Khoj search modal via left ribbon icon or the *Khoj: Search* command
|
|
||||||
- [X] Render results as Markdown preview to improve readability
|
|
||||||
- [X] Configure Khoj via the plugin setting tab on the settings page
|
|
||||||
- Set Obsidian Vault to Index with Khoj. Defaults to all markdown, PDF files in current Vault
|
|
||||||
- Set URL of Khoj backend
|
|
||||||
- Set Number of Search Results to show in Search Modal
|
|
||||||
- [X] Allow reranking of result to improve search quality
|
|
||||||
- [X] Allow Finding notes similar to current note being viewed
|
|
||||||
|
|||||||
@@ -1,12 +1,14 @@
|
|||||||
## Khoj Search
|
## Khoj Search
|
||||||
- **Using Obsidian**
|
### Use
|
||||||
- Click the *Khoj search* icon 🔎 on the [Ribbon](https://help.obsidian.md/User+interface/Workspace/Ribbon) or Search for *Khoj: Search* in the [Command Palette](https://help.obsidian.md/Plugins/Command+palette)
|
- **From Web**
|
||||||
- **Using Emacs**
|
|
||||||
- Run `M-x khoj <user-query>`
|
|
||||||
- **Using Web**
|
|
||||||
- Open <http://localhost:42110/> in your web browser
|
- Open <http://localhost:42110/> in your web browser
|
||||||
- **Using API**
|
- **From Obsidian**
|
||||||
- See the Khoj FastAPI [Swagger Docs](http://localhost:42110/docs), [ReDocs](http://localhost:42110/redocs)
|
- Click the *Khoj search* icon 🔎 on the [Ribbon](https://help.obsidian.md/User+interface/Workspace/Ribbon) or Search for *Khoj: Search* in the [Command Palette](https://help.obsidian.md/Plugins/Command+palette)
|
||||||
|
- **From Emacs**
|
||||||
|
- Run `M-x khoj <user-query>`
|
||||||
|
|
||||||
|
### Demo
|
||||||
|

|
||||||
|
|
||||||
### Query Filters
|
### Query Filters
|
||||||
|
|
||||||
|
|||||||
@@ -22,7 +22,7 @@ Run the following command in your terminal to install the Khoj backend.
|
|||||||
For more detailed Windows installation and troubleshooting, see [Windows Install](./windows_install.md).
|
For more detailed Windows installation and troubleshooting, see [Windows Install](./windows_install.md).
|
||||||
|
|
||||||
|
|
||||||
### 2. Run
|
### 2. Start
|
||||||
|
|
||||||
Run the following commmand from your terminal to start the Khoj backend and open Khoj in your browser.
|
Run the following commmand from your terminal to start the Khoj backend and open Khoj in your browser.
|
||||||
|
|
||||||
@@ -37,6 +37,8 @@ Note: To start Khoj automatically in the background use [Task scheduler](https:/
|
|||||||
2. Add your OpenAI API key to Chat Feature settings if you want to use Chat
|
2. Add your OpenAI API key to Chat Feature settings if you want to use Chat
|
||||||
3. Click `Configure` and wait. The app will download ML models and index the content for search and (optionally) chat
|
3. Click `Configure` and wait. The app will download ML models and index the content for search and (optionally) chat
|
||||||
|
|
||||||
|
[configure demo](./assets/khoj_configure_on_web.mp4 ':include :type=mp4')
|
||||||
|
|
||||||
### 4. Install Interface Plugins (Optional)
|
### 4. Install Interface Plugins (Optional)
|
||||||
Khoj exposes a web interface to search, chat and configure by default.<br />
|
Khoj exposes a web interface to search, chat and configure by default.<br />
|
||||||
The optional steps below allow using Khoj from within an existing application like Obsidian or Emacs.
|
The optional steps below allow using Khoj from within an existing application like Obsidian or Emacs.
|
||||||
|
|||||||
@@ -5,19 +5,19 @@ These steps can be used to setup Khoj on a clean, new Windows 11 machine. It has
|
|||||||
## Prerequisites
|
## Prerequisites
|
||||||
1. Ensure you have Visual Studio C++ Build tools installed. You can download it [from Microsoft here](https://visualstudio.microsoft.com/visual-cpp-build-tools/). At the minimum, you should have the following configuration:
|
1. Ensure you have Visual Studio C++ Build tools installed. You can download it [from Microsoft here](https://visualstudio.microsoft.com/visual-cpp-build-tools/). At the minimum, you should have the following configuration:
|
||||||
<img width="1152" alt="Screenshot 2023-07-12 at 3 56 25 PM" src="https://github.com/khoj-ai/khoj/assets/65192171/b506a858-2f5e-4c85-946b-5422d83f112a">
|
<img width="1152" alt="Screenshot 2023-07-12 at 3 56 25 PM" src="https://github.com/khoj-ai/khoj/assets/65192171/b506a858-2f5e-4c85-946b-5422d83f112a">
|
||||||
3. Ensure you have Python installed. You can check by running `python --version`. If you don't, install the latest version [from here](https://www.python.org/downloads/).
|
2. Ensure you have Python installed. You can check by running `python --version`. If you don't, install the latest version [from here](https://www.python.org/downloads/).
|
||||||
- Ensure you have pip installed: `py -m ensurepip --upgrade`.
|
- Ensure you have pip installed: `py -m ensurepip --upgrade`.
|
||||||
|
|
||||||
## Quick start
|
## Quick start
|
||||||
1. Open a PowerShell terminal.
|
1. Open a PowerShell terminal.
|
||||||
7. Run `pip install khoj-assistant`
|
2. Run `pip install khoj-assistant`
|
||||||
8. Start Khoj with `khoj`
|
3. Start Khoj with `khoj`
|
||||||
|
|
||||||
## Installation in a Virtual Environment
|
## Installation in a Virtual Environment
|
||||||
Use this if you want to install with a virtual environment. This will make it much easier to manage your dependencies. You can read more about [virtual environments](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/) here.
|
Use this if you want to install with a virtual environment. This will make it much easier to manage your dependencies. You can read more about [virtual environments](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/) here.
|
||||||
|
|
||||||
1. Open a PowerShell terminal with the `Run as Administrator` privileges.
|
1. Open a PowerShell terminal with the `Run as Administrator` privileges.
|
||||||
5. Create a virtual environment: `mkdir khoj && cd khoj && py -m venv .venv`
|
2. Create a virtual environment: `mkdir khoj && cd khoj && py -m venv .venv`
|
||||||
6. Activate the virtual environment: `.\.venv\Scripts\activate`. If you get a permissions error, then run `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned`.
|
3. Activate the virtual environment: `.\.venv\Scripts\activate`. If you get a permissions error, then run `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned`.
|
||||||
7. Run `pip install khoj-assistant`
|
4. Run `pip install khoj-assistant`
|
||||||
8. Start Khoj with `khoj`
|
5. Start Khoj with `khoj`
|
||||||
|
|||||||