QiXCite: Getting Started Guide

What is QiXCite?

QiXCite is a citation governance engine for legal AI. It prevents hallucinated citations, verifies authority existence, labels treatment coverage by source type, and produces verifiable evidence bundles for every verification.

QiXCite is part of the Quorum Integrity eXchange (QIX) framework by OrchIntel, purpose-built for law firms, legal departments, and compliance teams that use AI in their workflows.

Core Capabilities

Deployment Options

QiXCite runs in two modes. Choose the one that fits your organization's needs.

cd qixcite/
docker compose -f docker-compose.local.yml up -d

cd qixcite/
pip install -e .
./scripts/run_local.sh

export QIXCITE_MODE=local
export EVIDENCE_LOCAL_PATH=~/.qixcite/evidence
uvicorn qixcite.api:app --host 0.0.0.0 --port 8000

curl http://localhost:8000/healthz
# {"status":"healthy","mode":"local","version":"1.0.0"}

Microsoft Word Add-in

The QiXCite Word Add-in puts citation validation directly inside Microsoft Word. No command line, no extra software, no technical setup required.

Installation

1. Open Microsoft Word
2. Go to Insert > Get Add-ins (or Home > Add-ins depending on version)
3. Install via Microsoft AppSource if listed for your tenant, or use your organization's sideloaded manifest.xml
4. Open QiXCite from the Home ribbon after install

First Launch

When you open the QiXCite sidebar for the first time:

1. Click Scan This Document to start immediately
2. If signed out, you can run a limited preview without technical setup
3. When preview checks are used, or when cloud-only features are requested, sign in or create a free account
4. Use Advanced connection options only if you need local server mode, optional licensed/BYO connectors, or custom endpoints

Using the Add-in

Switching Modes

Cloud is the default path. Local mode and provider configuration remain available under Advanced connection options in the sidebar.

Privacy and Data Flow

QiXCite applies defensibility-first privacy controls across add-in, gateway, and evidence workflows.

• Citation verification does not require full document persistence in gateway fallback evidence bundles.
• Authority Alignment requires explicit consent for redacted excerpt processing.
• No external processing mode hard-blocks outbound alignment processing.
• Internal evidence APIs require service-to-service token authentication.

For the field-level outbound data matrix used in legal/procurement reviews, see QiXCite Privacy and Data Flow.

API Reference (Quick Start)

All endpoints are available at http://localhost:8000 (local) or https://api.orchintel.com/api/qixcite (cloud).

Verify a Single Citation

curl -X POST http://localhost:8000/verify \
  -H "Content-Type: application/json" \
  -d '{"citation": "Miranda v. Arizona, 384 U.S. 436 (1966)"}'

Scan a Document

curl -X POST http://localhost:8000/v1/documents/scan \
  -H "Content-Type: application/json" \
  -d '{"content": "As established in Miranda v. Arizona, 384 U.S. 436 (1966), the Court held that..."}'

Quote-Lock

curl -X POST http://localhost:8000/v1/cite/quote-lock \
  -H "Content-Type: application/json" \
  -d '{
    "citation": "Miranda v. Arizona, 384 U.S. 436 (1966)",
    "quote": "the prosecution may not use statements..."
  }'

Batch Processing

# Submit a batch
curl -X POST http://localhost:8000/v1/batch \
  -H "Content-Type: application/json" \
  -d '{
    "citations": [
      "Miranda v. Arizona, 384 U.S. 436 (1966)",
      "Roe v. Wade, 410 U.S. 113 (1973)",
      "Brown v. Board of Education, 347 U.S. 483 (1954)"
    ]
  }'

# Check batch status
curl http://localhost:8000/v1/batch/{batch_id}

View a Sample Evidence Bundle

curl http://localhost:8000/v1/evidence/sample

Returns a realistic sample evidence bundle showing exactly what auditors and regulators will see -- including compliance summary, risk assessment, and cryptographic signature.

E-Filing Precheck

curl -X POST http://localhost:8000/v1/efiling/precheck \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Your brief text here...",
    "jurisdiction": "US-FED",
    "court": "SCOTUS"
  }'

Cloud Mode Authentication

For IOA Cloud, add the Authorization header:

curl -X POST https://api.orchintel.com/api/qixcite/v1/documents/scan \
  -H "Authorization: Bearer ioa_usr_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"content": "..."}'

Configuration

QiXCite is configured via environment variables.

Core Settings

Citator Providers

Provider availability is policy-gated by jurisdiction, licensing, and deployment mode. Cloud starts with managed defaults; local/BYO mode can add optional licensed provider keys where permitted.

Cloud Coverage Matrix

Optional BYO Provider Keys (Advanced / Local)

Most cloud users do not need provider keys to start. Advanced users and local deployments can configure optional BYO provider keys as needed.

Validation Response Fields

Every citation validation returns these fields:

Status Meanings

Evidence Bundles

Every verification produces an evidence bundle containing:

In local mode, bundles are saved as JSON files to EVIDENCE_LOCAL_PATH.
In cloud mode, bundles are sent to the IOA Evidence Sink for centralized storage and retrieval.

Continuous Monitoring

Register citations for ongoing surveillance. QiXCite periodically re-checks them and notifies you when treatment status changes -- for example, if a cited case is overruled after your brief was filed.

Register Citations for Monitoring

curl -X POST http://localhost:8000/v1/monitor \
  -H "Content-Type: application/json" \
  -d '{
    "citations": ["384 U.S. 436", "347 U.S. 483"],
    "jurisdiction": "US-FED",
    "webhook_url": "https://your-firm.com/hooks/qixcite",
    "check_interval_hours": 24
  }'

List Active Monitors

curl http://localhost:8000/v1/monitor

Trigger an Immediate Re-check

curl -X POST http://localhost:8000/v1/monitor/{monitor_id}/check

Delete a Monitor

curl -X DELETE http://localhost:8000/v1/monitor/{monitor_id}

IOA Cloud Console Playground

If you're using IOA Cloud, the QiXCite Playground at console.orchintel.com/qixcite provides a web interface for testing citation validation without writing code.

How to Use the Playground

1. Log in at console.orchintel.com
2. Navigate to the QiXCite page
3. Use the Validate tab:
   • Enter a citation in the text field (e.g., 384 U.S. 436)
   • Select a jurisdiction from the dropdown
   • Click Validate
4. Results show:
   • Status badge (Valid, Questioned, Negative, Overruled, Unknown)
   • Authority level (Primary, Secondary, Persuasive)
   • Treatment lane labels (Licensed Treatment, Treatment Insight (Estimated • Beta), or Treatment Not Available)
   • Hallucination risk percentage
   • Evidence bundle reference

Sample Citations to Try

Support & Resources