Quickstart

from lighton import File, LightOn, Workspace

workspace_id = 42  # replace with your workspace ID

with LightOn() as client:  # reads LIGHTON_API_KEY from the environment
    workspace = Workspace.get(client, workspace_id)
    doc = workspace.ingest(File(path="handbook.pdf"))
    print(doc.id, doc.status)

import os
import requests

workspace_id = 42  # replace with your workspace ID
headers = {"Authorization": f"Bearer {os.environ['LIGHTON_API_KEY']}"}

with open("handbook.pdf", "rb") as f:
    response = requests.post(
        "https://api.lighton.ai/api/v3/files",
        headers=headers,
        data={"workspace_id": workspace_id},
        files={"file": f},
    )
print(response.json())

from lighton import File, LightOn

file_id = 1234  # the ID returned by the upload above

with LightOn() as client:
    doc = File.get(client, file_id)
    doc.wait()  # polls until ingestion reaches a terminal status
    print(doc.status)

import os
import time
import requests

file_id = 1234  # the ID returned by the upload above
headers = {"Authorization": f"Bearer {os.environ['LIGHTON_API_KEY']}"}

for _ in range(60):  # give up after ~2 minutes
    response = requests.get(
        f"https://api.lighton.ai/api/v3/files/{file_id}",
        headers=headers,
    )
    status = response.json()["status"]
    if status == "embedded":
        break
    time.sleep(2)
print(status)

from lighton import LightOn

workspace_id = 42  # replace with your workspace ID

with LightOn() as client:
    response = client.search(
        "What is the vacation policy at LightOn?",
        workspaces=[workspace_id],
        max_results=3,
    )
    for result in response.results:
        source = result.source
        print(f"[p.{source.page_start}–{source.page_end}, score={result.score:.2f}]")
        print(result.content[:120])
        print()

import os
import requests

workspace_id = 42  # replace with your workspace ID
headers = {"Authorization": f"Bearer {os.environ['LIGHTON_API_KEY']}"}

response = requests.post(
    "https://api.lighton.ai/api/v3/search",
    headers=headers,
    json={
        "query": "What is the vacation policy at LightOn?",
        "workspace_id": [workspace_id],
        "max_results": 3,
    },
)
for result in response.json()["results"]:
    print(f"[p.{result['source']['page_start']}–{result['source']['page_end']}, score={result['score']:.2f}]")
    print(result["content"][:120])
    print()