Python quick start - LightOn Developers

lighton-sdk wraps the LightOn API: typed models, pagination handled for you, and rate-limit pacing built in. It’s the code shown in the Python SDK tab of every tutorial snippet.

Requires Python 3.11 or later.

Install

uv add lighton-sdk

Set your API key in the environment. LightOn() reads it from there, so it never appears in your code:

export LIGHTON_API_KEY="..."

Your first result

from lighton import LightOn, Workspace

with LightOn() as client:  # reads LIGHTON_API_KEY from the environment
    workspace = Workspace(name="Docs").create(client)
    workspace.ingest_many(["docs/**/*.pdf"], wait=True)

    answer = client.ask("What were Q4 revenues?", workspaces=[workspace])
    print(answer.answer)

Where to go next

API reference

Every public class, method, and type, generated from the installed SDK.

Tutorials

Task-by-task walkthroughs, each with a Python SDK tab.

For parse, extract, async jobs, and agent-framework integrations (LangChain, LangGraph, LlamaIndex, OpenAI Agents, CrewAI), see the SDK README.

SDKs Python SDK reference

⌘I

​Install

​Your first result

​Where to go next

API reference

Tutorials

Install

Your first result

Where to go next