Skip to content

docs(install): add Katana install and WSL2 setup guide (#4109) #4110

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

juangcarmona
Copy link

Closes #4109 I created today

This PR improves the installation experience by updating the documentation for:

  • Linux: Adds Katana installation instructions, referencing official releases. It is a mandatory dependency to enable developer documentation indexing...
  • WSL2: Adds a dedicated WSL2 setup page that simplifies local installation with Windows + Ubuntu under WSL2. Encourages users to choose between Ubuntu 22.04 (CUDA 11) or 24.04 (CUDA 12).

I tried to keep changes and additions as concise as possible . Please, let me know if you'd like the WSL2 page linked from the Windows doc sidebar too.

Thanks for this awesome project 🙌

@juangcarmona juangcarmona changed the title Socs: add Katana install instructions (Linux) and WSL2 setup guide (#4109) docs(install): add Katana install and WSL2 setup guide (#4109) Apr 3, 2025
@wsxiaoys wsxiaoys requested a review from zwpaper April 7, 2025 02:04
Copy link
Member

@zwpaper zwpaper left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @juangcarmona, Thank you for the pr; it could enhance the Tabby user experience!

However, I have noticed an area that could be improved:

  1. Some files have been altered unnecessarily; this may be due to file mode changes. Please revert these modifications.
  2. Please divide this PR into two separate ones, each with a specific focus: one for the Katana changes, and another for the WSL.

@@ -28,6 +28,23 @@ Running Tabby on Linux using Tabby's standalone executable distribution.
* Check your local CUDA version by running the following command in a terminal: `nvcc --version`
* For the Vulkan version you'll need the vulkan library. In ubuntu, this would be `sudo apt install libvulkan1`.

## Katana (optional but recommended)

Tabby uses [Katana](https://github.com/projectdiscovery/katana) as a crawling backend for context providers.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Tabby uses [Katana](https://github.com/projectdiscovery/katana) as a crawling backend for context providers.
Tabby utilizes [Katana](https://github.com/projectdiscovery/katana) as a crawling backend for the `developer docs` context provider.

## Katana (optional but recommended)

Tabby uses [Katana](https://github.com/projectdiscovery/katana) as a crawling backend for context providers.
If you want Tabby to **import and reason over documentation**, Katana is required.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you want Tabby to **import and reason over documentation**, Katana is required.
To import and analyze `developer docs` when llms.txt is unavailable at the specified link, Katana is required.


Tabby uses [Katana](https://github.com/projectdiscovery/katana) as a crawling backend for context providers.
If you want Tabby to **import and reason over documentation**, Katana is required.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Please be aware that the minimum Katana version required is `1.1.2`.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve installation docs: add Katana install (Linux) + WSL2 mention (Windows)
2 participants