Getting Started

Installation

Install the core library using pip or uv:

pip install snowloader

uv add snowloader

To use the LangChain or LlamaIndex adapters, install the corresponding extras:

pip install snowloader[langchain]    # LangChain adapter
pip install snowloader[llamaindex]   # LlamaIndex adapter
pip install snowloader[all]          # Both adapters

uv add snowloader[langchain]    # LangChain adapter
uv add snowloader[llamaindex]   # LlamaIndex adapter
uv add snowloader[all]          # Both adapters

Requirements

  • Python 3.10 or later

  • A ServiceNow instance with REST API access

  • A ServiceNow user account with appropriate roles (itil, knowledge, or admin)

Connecting to ServiceNow

Every interaction with ServiceNow starts with a SnowConnection:

from snowloader import SnowConnection

conn = SnowConnection(
    instance_url="https://mycompany.service-now.com",
    username="admin",
    password="password",
)

The connection handles authentication, pagination, retry logic, and rate limiting. See Authentication for all supported auth modes and Configuration Reference for tuning parameters.

Loading Your First Documents

Load incidents and iterate over them:

from snowloader import SnowConnection, IncidentLoader

conn = SnowConnection(
    instance_url="https://mycompany.service-now.com",
    username="admin",
    password="password",
)

loader = IncidentLoader(connection=conn, query="active=true^priority<=2")

# Stream documents one at a time (memory efficient)
for doc in loader.lazy_load():
    print(f"[{doc.metadata['number']}] {doc.page_content[:100]}")

# Or load everything into a list
all_docs = loader.load()
print(f"Loaded {len(all_docs)} incidents")

Each document has two parts:

  • page_content - structured text formatted for LLM consumption

  • metadata - a dict with sys_id, number, table, and other fields useful for filtering and linking

Using with LangChain

from snowloader import SnowConnection
from snowloader.adapters.langchain import ServiceNowIncidentLoader

conn = SnowConnection(
    instance_url="https://mycompany.service-now.com",
    username="admin",
    password="password",
)

loader = ServiceNowIncidentLoader(connection=conn, query="active=true")
docs = loader.load()  # Returns list[langchain_core.documents.Document]

# Use with any LangChain vector store
from langchain_community.vectorstores import FAISS
from langchain_openai import OpenAIEmbeddings

vectorstore = FAISS.from_documents(docs, OpenAIEmbeddings())

Using with LlamaIndex

from snowloader import SnowConnection
from snowloader.adapters.llamaindex import ServiceNowIncidentReader

conn = SnowConnection(
    instance_url="https://mycompany.service-now.com",
    username="admin",
    password="password",
)

reader = ServiceNowIncidentReader(connection=conn, query="active=true")
docs = reader.load_data()  # Returns list[llama_index.core.schema.Document]

# Use with any LlamaIndex index
from llama_index.core import VectorStoreIndex

index = VectorStoreIndex.from_documents(docs)
query_engine = index.as_query_engine()

Next Steps