README.md

---
title: Project Intelligence Hub
emoji: 🔍
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.3.0
app_file: app.py
pinned: false
license: mit
short_description: PDF reports to queryable knowledge graph
---

# Project Intelligence Hub

Transform PDF project reports into a queryable Neo4j knowledge graph with natural language queries.

## Features

- **PDF Ingestion** — Extract entities and relationships from project reports
- **Knowledge Graph** — Build structured graph with Projects, Budgets, Locations, Milestones, Challenges
- **Hybrid Search** — Vector embeddings + BM25 keyword search
- **Natural Language Q&A** — Query the graph using plain English

## Setup (Required Secrets)

Configure these in **Settings > Repository secrets**:

| Secret | Description |
|--------|-------------|
| `TOGETHER_API_KEY` | Together AI API key |
| `NEO4J_URI` | Neo4j connection URI (e.g., `neo4j+s://xxx.databases.neo4j.io`) |
| `NEO4J_USERNAME` | Neo4j username (usually `neo4j`) |
| `NEO4J_PASSWORD` | Neo4j password |
| `NEO4J_DATABASE` | Neo4j database name (usually `neo4j`) |

## Tech Stack

- **LLM**: Together AI (DeepSeek-V3)
- **Embeddings**: m2-bert-80M-8k-retrieval
- **Graph DB**: Neo4j Aura
- **Reranker**: ms-marco-MiniLM-L-6-v2
- **UI**: Gradio