ClearDocs is a web application that allows users to analyze contracts and medical bills instantly using AI. It scans uploaded PDFs, automatically omits sensitive information, and highlights key issues, hidden clauses, or confusing parts in the document.
- Scan PDFs Instantly – Upload contracts or medical bills and ClearDocs processes them quickly.
- Protect Sensitive Data – Automatically removes names, addresses, and IDs before analysis.
- Highlight Key Issues – Shows flags, suggested solutions, and relevant quotes from the document.
- Easy-to-read Results – Each result is displayed as a clean card for better readability.
- Frontend: React, TypeScript, TailwindCSS
- Backend: FastAPI
- AI Analysis: Custom backend logic or integration with AI model
- File Uploads: FormData via HTTP POST
git clone https://github.com/hhh4164/hackbu2026.git
cd cleardocs
cd frontend
npm i
npm run dev
cd ../backend
python -m venv venv
# macOS/Linux
source venv/bin/activate
# Windows
venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload --host 127.0.0.1 --port 8000- Open the frontend at http://localhost:5173 (Vite default port).
- Select Contract or Medical Bill
- Upload your PDF file
- Click Analyze PDF
- View the results displayed as cards showing Flag, Solution, and optional Quote.
[
{
"flag": "Late Payment Fee",
"solution": "Notify the client about the 10% penalty and interest",
"quote": "Late payments will incur a 10% penalty plus 1.5% monthly interest"
},
{
"flag": "Hidden Cancellation Fee",
"solution": "Make sure to cancel at least 30 days before renewal",
"quote": "Early termination will result in a $250 fee"
}
]cleardocs/ ├─ frontend/ # React + Tailwind app │ ├─ src/ │ │ ├─ components/ │ │ │ ├─ Card.tsx │ │ │ └─ ResultCard.tsx │ │ └─ pages/ │ │ └─ Home.tsx ├─ backend/ # FastAPI server │ ├─ main.py │ ├─ redactor.py # Handles sensitive information redaction │ └─ requirements.txt
The README and the text on the cards are all generated by AI