iris-vector-graph 1.2.0

Graph + Vector retrieval system for InterSystems IRIS with hybrid search, openCypher, and GraphQL APIs

IRIS Vector Graph

The ultimate Graph + Vector + Text Retrieval Engine for InterSystems IRIS.

IRIS Vector Graph is a general-purpose graph utility built on InterSystems IRIS that supports and demonstrates knowledge graph construction and query techniques. It combines graph traversal, HNSW vector similarity, and lexical search in a single, unified database.

---

Why IRIS Vector Graph?

• Multi-Query Power: Query your graph via SQL, openCypher, or GraphQL — all on the same data.
• Blazing Fast Vectors: Native HNSW indexing delivering ~1.7ms search latency (vs 5.8s standard).
• Zero-Dependency Integration: Built with IRIS Embedded Python — no external vector DBs or graph engines required.
• Production-Ready: The engine behind iris-vector-rag for advanced RAG pipelines.

---

Quick Start

# 1. Clone & Sync
git clone https://github.com/intersystems-community/iris-vector-graph.git && cd iris-vector-graph
uv sync

# 2. Spin up IRIS
docker-compose up -d

# 3. Start API
uvicorn api.main:app --reload

Visit:

• GraphQL Playground: http://localhost:8000/graphql
• API Docs: http://localhost:8000/docs

---

Unified Query Engines

openCypher

MATCH (p:Protein {id: "PROTEIN:TP53"})-[:interacts_with*1..2]->(target)
RETURN p.name, target.name

GraphQL

query {
  protein(id: "PROTEIN:TP53") {
    name
    interactsWith(first: 5) { id name }
    similar(limit: 3) { protein { name } similarity }
  }
}

SQL (Hybrid)

SELECT TOP 10 id, 
       kg_RRF_FUSE(id, vector, 'cancer suppressor') as score
FROM nodes
ORDER BY score DESC

---

Performance

Operation	Standard IRIS	ACORN-1 (HNSW)	Gain
Vector Search	5,800ms	1.7ms	3400x
Graph Hop	1.0ms	0.09ms	11x
Ingestion	29 nodes/s	6,496 nodes/s	224x

---

Interactive Demos

Experience the power of IRIS Vector Graph through our interactive demo applications.

Biomedical Research Demo

Explore protein-protein interaction networks with vector similarity and D3.js visualization.

Fraud Detection Demo

Real-time fraud scoring with transaction networks and bitemporal audit trails.

To run the demos:

# Start the demo server
export PYTHONPATH=$PYTHONPATH:$(pwd)/src
uv run uvicorn src.iris_demo_server.app:app --port 8200 --host 0.0.0.0

Visit http://localhost:8200 to begin.

---

iris-vector-rag Integration

IRIS Vector Graph is the core engine powering iris-vector-rag. You can use it in your RAG pipelines like this:

from iris_vector_rag import create_pipeline

# Create a GraphRAG pipeline powered by this engine
pipeline = create_pipeline('graphrag')

# Combined vector + text + graph retrieval
result = pipeline.query(
    "What are the latest cancer treatment approaches?",
    top_k=5
)

---

Documentation

• Detailed Architecture
• Biomedical Domain Examples
• Full Test Suite
• iris-vector-rag Integration
• Verbose README (Legacy)

---

Author: Thomas Dyar ([e-mail])