Introduction

Welcome to the simplechatbot Python package! This package provides tools for working with LLM agents - in particular, chatbots that track tools and conversation history.

See the examples in the navigation bar to the left!

Installation

pip install git+https://github.com/devincornell/simplechatbot.git

When inside the package directory: Basic install:

pip install .

This package uses buildtools - see pyproject.toml for package details.

Makefile

You can also use make.

To install:

make install
make reinstall
make uninstall

Importing

Basic importing works as you would expect.

import simplechatbot

Generating Documentation

The Makefile has most of these commands, but including them here jsut in case.

pip install mkdocs
pip install mkdocs-material

Start Test Server

mkdocs serve

Build the documentation.

mkdocs build

Publish the documation

mkdocs gh-deploy --force

Example Documentation

In the Makefile I included the commands that will take example jupyter notebooks and convert them to markdown so that mkdocs can eventually convert them to html for the website. Simply add a notebook to the site_examples folder and it will be automatically converted to markdown and placed in the right folder.

EXAMPLE_NOTEBOOK_FOLDER = ./site_examples/# this is where example notebooks are stored
EXAMPLE_NOTEBOOK_MARKDOWN_FOLDER = ./docs/examples/# this is where example notebooks are stored

example_notebooks:
    -mkdir $(EXAMPLE_NOTEBOOK_MARKDOWN_FOLDER)
    python -m pymddoc ipynb2md-multi $(EXAMPLE_NOTEBOOK_FOLDER)/*.ipynb
    mv $(EXAMPLE_NOTEBOOK_FOLDER)/*.md $(EXAMPLE_NOTEBOOK_MARKDOWN_FOLDER)