Skip to content

add chatbot ui to docs#845

Merged
jwilber merged 5 commits intomainfrom
jwilber/docs-chatbot
Jun 3, 2025
Merged

add chatbot ui to docs#845
jwilber merged 5 commits intomainfrom
jwilber/docs-chatbot

Conversation

@jwilber
Copy link
Collaborator

@jwilber jwilber commented Apr 24, 2025

Description

Adds a chatbot UI to our documentation:
image

In particular, I've injected the compiled static assets for the production build of the NVES chat bot app into our mkdocs page. (The BioNeMo 2 docs are being indexed for this chatbot).

Because of the different rendering strategies used between react and mkdocs, we need to turn off the navigation.instant and navigation.instant.prefetch features of mkdocs to allow for the chat to work on navigation.

Note - because we don't have a great system for testing changes in live docs, I've made the default behavior for the chatbot invisible/unclickable, so we can turn it on with dev tools and investigate in 'secret' 🥷.

Type of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Refactor
  • Documentation update
  • Other (please describe):

Note

By default, the notebooks validation tests are skipped unless explicitly enabled.

Usage

Checkout this branch, and in the root of the repo, build the docs

docker build -t nvcr.io/nvidian/cvai_bnmo_trng/bionemo2-docs -f docs/Dockerfile .

then run the docs:

docker run --rm -it -p 8000:8000 \
    -v ${PWD}/docs:/docs -v ${PWD}/sub-packages:/sub-packages \
    nvcr.io/nvidian/cvai_bnmo_trng/bionemo2-docs:latest

@copy-pr-bot
Copy link

copy-pr-bot bot commented Apr 24, 2025

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@jwilber jwilber requested a review from tshimko-nv as a code owner May 22, 2025 23:05
jwilber added 3 commits May 28, 2025 11:39
Signed-off-by: Jared Wilber <jwilber@nvidia.com>
Signed-off-by: Jared Wilber <jwilber@nvidia.com>
Signed-off-by: Jared Wilber <jwilber@nvidia.com>
@jwilber jwilber force-pushed the jwilber/docs-chatbot branch from 9317eb1 to fc34627 Compare May 28, 2025 18:40
Signed-off-by: Jared Wilber <jwilber@nvidia.com>
@jwilber jwilber changed the title draft: add chatbot ui to docs add chatbot ui to docs May 28, 2025
@jwilber
Copy link
Collaborator Author

jwilber commented May 28, 2025

/ok to test 298a98b

@copy-pr-bot
Copy link

copy-pr-bot bot commented May 28, 2025

/ok to test 298a98b

@jwilber, there was an error processing your request: E2

See the following link for more information: https://docs.gha-runners.nvidia.com/cpr/e/2/

@jwilber jwilber added documentation Improvements or additions to documentation SKIP_CI labels May 28, 2025
@jwilber jwilber self-assigned this May 28, 2025
Copy link
Collaborator

@trvachov trvachov left a comment

Choose a reason for hiding this comment

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

lfg!!!

@jwilber
Copy link
Collaborator Author

jwilber commented Jun 3, 2025

/ok to test b1911a2

@jwilber jwilber added this pull request to the merge queue Jun 3, 2025
Merged via the queue into main with commit bfa7d4d Jun 3, 2025
10 checks passed
@jwilber jwilber deleted the jwilber/docs-chatbot branch June 3, 2025 20:23
camirr-nv pushed a commit that referenced this pull request Jun 26, 2025
### Description
Adds a chatbot UI to our documentation:

![image](https://github.com/user-attachments/assets/974da52e-fdab-4d05-af67-e2d3ea296c00)

In particular, I've injected the compiled static assets for the
production build of the [NVES chat bot
app](https://gitlab-master.nvidia.com/nves/llm_bot/-/tree/main/chat_frontend)
into our `mkdocs` page. (The BioNeMo 2 docs are being indexed for this
chatbot).

Because of the different rendering strategies used between react and
mkdocs, we need to turn off the `navigation.instant` and
`navigation.instant.prefetch` features of mkdocs to allow for the chat
to work on navigation.

Note - because we don't have a great system for testing changes in live
docs, I've made the default behavior for the chatbot
invisible/unclickable, so we can turn it on with dev tools and
investigate in 'secret' 🥷.

### Type of changes
<!-- Mark the relevant option with an [x] -->

- [ ]  Bug fix (non-breaking change which fixes an issue)
- [x]  New feature (non-breaking change which adds functionality)
- [ ]  Refactor
- [x]  Documentation update
- [ ]  Other (please describe):

> [!NOTE]
> By default, the notebooks validation tests are skipped unless
explicitly enabled.

### Usage
Checkout this branch, and in the root of the repo, build the docs
```
docker build -t nvcr.io/nvidian/cvai_bnmo_trng/bionemo2-docs -f docs/Dockerfile .
```
then run the docs:

```
docker run --rm -it -p 8000:8000 \
    -v ${PWD}/docs:/docs -v ${PWD}/sub-packages:/sub-packages \
    nvcr.io/nvidian/cvai_bnmo_trng/bionemo2-docs:latest
```

---------

Signed-off-by: Jared Wilber <jwilber@nvidia.com>
Signed-off-by: Ubuntu <camirr@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants