Skip to main content

Setting up development environment

Note
Please note that Pebblo requires Python version 3.9 or above to function optimally.

Pebblo is currently supported in MacOS and Linux.

The following instructions are tested on Mac OSX and Linux (Debian).

Prerequisites​

Install the following prerequisites. This is needed for PDF report generation,

if you have put weasyprint as renderer in the config.yaml

Mac OSX​

brew install pango

Linux (debian/ubuntu)​

sudo apt-get install libpango-1.0-0 libpangoft2-1.0-0

Install weasyprint library​

pip install weasyprint

Build, Install and Run​

Fork and clone the pebblo repo. From within the pebblo directory, create a python virtual-env, build pebblo package (in wheel format), install and run.

Build​


# Fork and clone the pebblo repo
git clone https://github.com/<your-github-userid>/pebblo.git
cd pebblo

# Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Build pebblo python package
pip3 install build
python3 -m build --wheel

Build artifact as wheel package will be available in dist/pebblo-<version>-py3-none-any.whl

Install​

pip3 install dist/pebblo-<version>-py3-none-any.whl

Pebblo script will the install as .venv/bin/pebblo

Run Pebblo Server​

pebblo

Pebblo server now listens to localhost:8000 to accept Gen-AI application document snippets for inspection and reporting.

Creating a pull request​

See these instructions to open a pull request against the main Pebblo repo.

Communication​

Please join Discord server https://discord.gg/wyAfaYXwwv to reach out to the Pebblo maintainers, contributors and users.

Discord