FileOracle 🔮

FileOracle is an AI-powered local file tree scraper, graph visualizer, and attestation engine with deep provenance tracking, cryptographic hashing (SHA-256 / Merkle trees), and multi-platform deployment capability.

Features

• FastAPI Backend: RESTful API exposing /health, /query, and /graph endpoints.
• Local File Graph Engine: Scans directory trees, builds node/edge graphs, and calculates cryptographic provenance records & Merkle roots.
• Modern Glassmorphism Frontend: Responsive dark mode UI using Inter typography, micro-animations, and interactive D3.js graph rendering.
• DeepWiki Agent Continuity: Consolidated documentation architecture detailing work continuity and memory persistence.
• Multi-Cloud Ready: Scaffolding and configs for Vercel, Netlify, Docker, Hugging Face Spaces, and GitHub Actions.

Project Structure

FileOracle/
├── backend/
│   ├── __init__.py
│   ├── fileoracle.py       # Core FileOracle AI engine
│   ├── graph.py            # Graph builder & SHA-256/Merkle attestation
│   ├── main.py             # FastAPI entry point
│   ├── requirements.txt    # Backend dependencies
│   └── tests/              # Pytest test suite
├── frontend/
│   ├── app.js              # Client logic & D3 visualization
│   ├── index.html          # HTML5 SPA landing page
│   └── styles.css          # Glassmorphism dark mode stylesheet
├── docs/
│   └── DeepWiki_Consolidated.md # DeepWiki docs with agent memory architecture
├── .github/workflows/
│   └── deploy.yml          # GitHub Actions CI/CD workflow
├── Dockerfile              # Docker / Hugging Face Spaces build
├── netlify.toml            # Netlify deployment configuration
├── vercel.json             # Vercel serverless configuration
└── README.md

Quick Start

1. Local Development

# Clone repository
git clone https://github.com/overandor/FileOracle.git
cd FileOracle

# Create virtual environment & install dependencies
python3 -m venv venv
source venv/bin/activate
pip install -r backend/requirements.txt
pip install pytest httpx

# Run tests
pytest backend/

# Start FastAPI server
uvicorn backend.main:app --reload --port 8000

Visit http://localhost:8000 in your browser.

2. Run with Docker

docker build -t fileoracle .
docker run -p 7860:7860 fileoracle

License

MIT License.