​

Getting Started

This guide explains how to use Outerport’s Python SDK to make API calls.

​

Installation

You can install the Outerport Python SDK from PyPI (Python Package Index).

pip install outerport

​

Initializing the Client

To use the Outerport Python SDK, you need to first get your Outerport API key.

Once you have your API key, you can initialize the client as follows:

from outerport import OuterportClient

client = OuterportClient(api_key="your_api_key")

​

Using a Self-Hosted Outerport API service

If you are hosting your own Outerport API, you can set the base_url to the URL of your hosted API.

client = OuterportClient(
    api_key="your_api_key",
    base_url="http://localhost:8080"
)

​

Basic Usage

​

Uploading a Document

You can upload a document using the client.documents.create method.

with open("document.pdf", "rb") as f:
    doc = client.documents.create(file=f)

The client.documents.create method returns a Document object.

​

Asking a Question

You can ask a question about a document using the client.questions.create method.

question = client.questions.create(
    document_ids=[doc.id],
    question="What is our password policy?"
)

The client.questions.create method returns a Question object.

print(question.final_answer)

In addition to the question.final_answer, the question.plan and question.evidences contain the process of answering the question. For example, question.evidences returns the following result:

print(question.evidences)

​

Searching for Relevant Documents

You can search for relevant documents using the client.documents.search method.

documents = client.documents.search(query="Tell me about the password policy")

The client.documents.search method returns a list of Document objects.

You can also specify a tag or folder to search for.

documents = client.documents.search(
    query="Explain the password policy", 
    tag="security"
)