Metadata-Version: 2.4
Name: fileoracle
Version: 1.0.0
Summary: AI-powered local file tree scraper, provenance attestation graph engine, and web oracle
Author-email: Joseph Skrobynets <j.skrobynets@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/overandor/FileOracle
Project-URL: Repository, https://github.com/overandor/FileOracle
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.111.0
Requires-Dist: uvicorn[standard]>=0.30.1
Requires-Dist: pydantic>=2.0.0
Requires-Dist: requests>=2.28.0

# 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

```bash
# 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

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

## License
MIT License.
