IssunDB Example Applications

This repository includes a collection of example applications that use the IssunDB graph database.

---

Examples

Currently, the following table lists the included examples:

#	Example	Language	Description
1	GraphRAG Pipeline	Rust	Knowledge graph extraction and retrieval-augmented generation using an LLM.
2	Codebase Explorer	Rust	Syntax dependency graph constructor and function ranking using PageRank.
3	Fraud Detection System	Python	Real-time financial transaction stream analyzer using Cypher queries.
4	Social Recommendation System	Python	Hybrid friend and content recommender using collaborative filtering and semantic search.

---

Quickstart

Prerequisites

To build and run the example applications, you need:

• Rust (version 1.85 or newer) toolchain: Install Rust
• Python (version 3.10 or newer) with uv package manager: Install uv

Setup

1. Clone the repository:

   git clone https://github.com/IssunDB/example-apps.git
   cd example-apps

2. Set up the Python virtual environment and install dependencies:

   uv sync --all-extras

3. Build the Rust applications:

   make build

Running the Demos

You can run any of the demos using the provided Makefile targets:

• Run the GraphRAG pipeline:

  make demo-grag

• Run the Codebase Explorer:

  make demo-code-exp

• Run the Fraud Detection stream:

  make demo-fraud

• Run the Social Recommendation system:

  make demo-recommend

---

Reporting Bugs

Please report bugs and issues you encounter via the issue page.

License

This project is licensed under the MIT License (see LICENSE).