diff --git a/README.md b/README.md index b4585d66..85727ceb 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,7 @@ pip install pebblo ```bash pebblo ``` +see [troubleshooting](docs/gh_pages/docs/troubleshooting.md) guide for troubleshooting info. Pebblo daemon now listens to `localhost:8000` to accept Gen-AI application data snippets for inspection and reporting. diff --git a/docs/gh_pages/docs/installation.md b/docs/gh_pages/docs/installation.md index f96d9df2..97acdc3e 100644 --- a/docs/gh_pages/docs/installation.md +++ b/docs/gh_pages/docs/installation.md @@ -27,3 +27,5 @@ pebblo ``` Pebblo daemon now listens to `localhost:8000` to accept Gen-AI application data snippets for inspection and reporting. + +see [troubeshooting](troubleshooting.md) if you face any issues. diff --git a/docs/gh_pages/docs/introduction.md b/docs/gh_pages/docs/introduction.md index e8fe4623..287da677 100644 --- a/docs/gh_pages/docs/introduction.md +++ b/docs/gh_pages/docs/introduction.md @@ -32,3 +32,4 @@ Pebblo has two components. - [Pebblo Daemon](daemon.md) - [Pebblo Safe DataLoader for Langchain](rag.md) - [Reports](reports.md) +- [Troubleshooting](troubleshooting.md) diff --git a/docs/gh_pages/docs/troubleshooting.md b/docs/gh_pages/docs/troubleshooting.md new file mode 100644 index 00000000..6b2406e1 --- /dev/null +++ b/docs/gh_pages/docs/troubleshooting.md @@ -0,0 +1,15 @@ +# Troubleshooting Pebblo + +## Issued found in conda virtual env. +### 1. OSError: cannot load library 'pango-1.0-0' + Install pango package in conda env + + `conda install -c anaconda pango` + +### 2. OSError: cannot load library 'gobject-2.0-0': gobject-2.0-0: cannot open shared object file + Install libpango binaries + + ```bash + sudo apt-get update + sudo apt-get install libpango1.0-0 + ``` diff --git a/docs/gh_pages/sidebars.ts b/docs/gh_pages/sidebars.ts index 42a7a02f..df1d1e5b 100644 --- a/docs/gh_pages/sidebars.ts +++ b/docs/gh_pages/sidebars.ts @@ -32,6 +32,11 @@ const sidebars: SidebarsConfig = { id: "reports", // document ID label: "Reports", // sidebar label }, + { + type: "doc", + id: "troubleshooting", // document ID + label: "Troubleshooting guide", // sidebar label + }, ], };