ninebit-ciq 1.1.0

Thin client for interacting with NineBit CIQ backend

Python SDK for RAG (Retrieval Augmented Generation)

🔗 ninebit-ciq

Official Python SDK client for interacting with NineBit CIQ, a Retrieval-Augmented Generation (RAG) workflow orchestration platform for secure, private, rapid prototyping of AI/ML ideas using enterprise data and open-source models.

🚀 Try It Out Interactively

We provide an interactive Jupyter notebook demo to quickly explore NineBit CIQ’s features like ingestion, summarization, taxonomy extraction, and more.

🧪 Run the notebook in Google Colab

Click below to launch the demo with zero setup:

---

🌐 Explore Our Hugging Face Space

Try the live demo running on Hugging Face Spaces — no installation needed, just open and run:

https://huggingface.co/spaces/ninebit/ciq-rag

---

For more details, see examples/ciq_rag_demo.ipynb.

🚀 Features

• Retrieval-Augmented Generation (RAG) Perform semantic search and intelligent query answering using hybrid retrieval techniques.
• Flexible Query Interface Send queries with configurable similarity thresholds and top_k result tuning.
• Callback Support for Asynchronous Workflows Pass in callbacks to handle results or errors once workflows complete — ideal for event-driven applications.
• Workflow Polling with Timeout Control Monitor long-running workflows with built-in polling, status checking, and customizable timeouts.
• Simple, Extensible API Clean, Pythonic interfaces with support for both synchronous returns and optional callbacks.
• Error-Handled Execution Flow Graceful handling of task failures, timeouts, and unexpected states with descriptive exceptions.
• Logging Support Integrated logging for easy debugging and transparency during polling or querying.

📦 Installation

pip install ninebit-ciq

Or clone and install locally:

git clone https://github.com/NineBit-Computing/ciq-py-client.git
cd ciq-py-client
pip install .

🧪 Quickstart (Python)

from ninebit_ciq import NineBitCIQClient

client = NineBitCIQClient(
    api_key="YOUR_API_KEY"
)

def on_done(error, data):
    if error:
        print(f"Ingest_file failed: {error}")
    else:
        print(f"Ingest_file succeeded: {str(data)}")

# 1. Ingest file as datasource for performing RAG
client.ingest_file(file="files/my_file.pdf", callback=on_done)

# 2. Ask your query
query = "What are land breeze?"
response = client.rag_query(query=query)
print(f"Query response is {response}")

🔐 Authentication - You’ll Need an API Key

If you’re using the Freemium CIQ setup, you’ll just need to register at our web app and grab your API key. It’s quick, and no credit card is required.

You can sign up here NineBit CIQ

📚 SDK Reference

Method	Description
ingest_file()	Reads and uploads a PDF or DOCX file to the backend for processing.
rag_query()	Performs a Retrieval-Augmented Generation (RAG) query using the provided input.

🛠️ Logging

You can control logging verbosity:

from ninebit_ciq import NineBitCIQClient
import logging

client = NineBitCIQClient(api_key, log_level=logging.INFO)

📁 Project Structure

ciq-py-client/
├── src/ninebit_ciq/
│ ├── client.py # Core SDK logic
│ ├── logger.py # Logger setup
│ ├── cli.py # CLI interface
│ └── **init**.py # Version info
├── examples/usage.py
├── examples/usage_with_thread.py
├── README.md
├── setup.py
└── version.txt

📄 License

MIT License © NineBit Computing

🤝 Contributing

Pull requests are welcome! Please check DEVELOPER.md and ensure:

• Tests pass
• Lint/format clean
• Coverage is not broken

📬 Questions?

Email us at [e-mail] or visit NineBit Computing or raise an issue in the GitHub repo.

© NineBit Computing, 2025