NOSIBLE Search Client

Welcome to the NOSIBLE Client package! This documentation will give you an in-depth overview of the NOSIBLE Search API, and show you how to harness the power of the NOSIBLE Search Engine.

📦 Installation

Important

If you are using a new API key (format starting with nos_sk_...), you must update to package version 0.3.12 or newer.

pip install nosible

⚡ Installing with uv

uv pip install nosible

Requirements:

  • Python 3.9+

  • polars

  • duckdb

  • openai

  • tantivy

  • pyrate-limiter

  • tenacity

  • cryptography

  • pyarrow

  • pandas

🔑 Authentication

  1. Sign in to NOSIBLE and grab your free API key.

  2. Set it as an environment variable or pass directly:

On Windows

$Env:NOSIBLE_API_KEY="nos_sk_..."
$Env:LLM_API_KEY="sk-..."  # for query expansions (optional)

On Linux

export NOSIBLE_API_KEY="nos_sk_..."
export LLM_API_KEY="sk-..."  # for query expansions (optional)

Or in code:

  • As an argument:

from nosible import Nosible

client = Nosible(
    nosible_api_key="nos_sk_...",
    llm_api_key="sk-...",
)
  • As an environment variable:

from nosible import Nosible
import os

os.environ["NOSIBLE_API_KEY"] = "nos_sk_..."
os.environ["LLM_API_KEY"] = "sk-..."

🤖 Cybernaut 1

An AI agent with unrestricted access to everything in NOSIBLE including every shard, algorithm, selector, reranker, and signal. It knows what these things are and can tune them on the fly to find better results.

from nosible import Nosible

with Nosible(nosible_api_key="YOUR API KEY") as client:

    results = client.search(
        # search() gives you access to Cybernaut 1
        prompt="Find me interesting technical blogs about Monte Carlo Tree Search."
    )

    print(results)

⚒️ Examples and Demos

To easily view examples of how to use the client package, or demos to see what can be achieved with the NOSIBLE search engine, view our examples and demos page.

🚫 Rate Limits

To find rate limits and pricing info for the NOSIBLE Search API, visit our subscriptions page..

📡 Swagger Docs

You can find online endpoints to the NOSIBLE Search API Swagger Docs here.


API reference