mirror of
https://github.com/kennethreitz/instructor.git
synced 2026-06-05 22:50:18 +00:00
Ivan
58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
# Introduction
|
|
|
|
This section includes a list of notebooks that walk you through some simple concepts in Instructor. We start small and then work our way up to more complex and tricky implementations using the library.
|
|
|
|
## Overview
|
|
|
|
Currently we have the following notebooks avaliable
|
|
|
|
1. `Introduction` - This is a quick walkthrough some of the benefits of Pydantic and how the Instructor Library integrates nicely with Pydantic with `instructor.patch()`
|
|
|
|
2. `Tips` - Quick demonstration of how to use enums, `Pydantic` models and structured prompting to get specific output formats
|
|
|
|
3.
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
We utilise the Graphviz package in this tutorial series. If you don't have it on hand, you should download it. Mac users can do so by running `brew install graphviz` while Linux users can try `sudo apt install graphviz` ( modify to your system specific package manager).
|
|
|
|
If you're encountering an error like the following when trying to run graphviz after installing it, just restart the notebook and verify you've got graphviz installed by running `dot -v` in your shell.
|
|
|
|
```
|
|
Command '[PosixPath('dot'), '-Kdot', '-Tsvg']' died with <Signals.SIGKILL: 9>.
|
|
```
|
|
|
|
Here are the steps to start running the notebooks
|
|
|
|
1. Create a virtual environment
|
|
|
|
```
|
|
python3 -m venv .venv
|
|
source .venv .venv/bin/activate
|
|
```
|
|
|
|
2. Install the dependencies
|
|
|
|
```
|
|
pip3 install -r requirements.txt
|
|
```
|
|
|
|
3. Add the virtual environment to Jupyter notebook
|
|
|
|
```
|
|
python -m ipykernel install --user --name=instructor-env
|
|
```
|
|
|
|
4. Add OpenAI API Key into your shell by running the following command. This will be set for as long as the shell is open.
|
|
|
|
```
|
|
export OPENAI_API_KEY=<api key goes here>
|
|
```
|
|
|
|
5. Start Jupyter Notebook
|
|
|
|
```
|
|
jupyter notebook
|
|
``` |