---
title: CC-RAG Neo4j Prototype
emoji: 🕸️
colorFrom: indigo
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: mit
---

# CC-RAG Neo4j Prototype

Demonstrates Causal-Chain Retrieval-Augmented Generation using Neo4j.

Extracts cause-relation-effect triples from documents, stores them as a causal graph in Neo4j, retrieves forward/backward causal chains, and generates answers grounded in those chains.

## Environment Variables

```
OPENAI_API_KEY=...
OPENAI_MODEL=gpt-4o-mini
NEO4J_AUTH=none
```

## Local Build

```bash
docker build -t ccrag-neo4j .
docker run -p 7860:7860 -e OPENAI_API_KEY=$OPENAI_API_KEY ccrag-neo4j
```

## Hugging Face Spaces

Create a Docker Space and push this repository. App listens on port 7860.

## Warning

This prototype runs Neo4j with authentication disabled inside the container. Do not expose Neo4j ports publicly. For demo/prototype use only.

Graph data is not persisted across container restarts unless Hugging Face persistent storage is mounted at `/data`.