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.