# Philmatic

> Philmatic is a deterministic, local-first document compliance and universal media processing engine. It runs client-side in the browser using WebAssembly, Web Workers, and Canvas pipelines to guarantee zero server uploads, complete data privacy, and deterministic formatting of photos, signatures, and PDFs to strict government exam and institutional application criteria.

## Core Capabilities

- **Automated Exam & Application Compliance**: Pre-configured deterministic rules for 75+ competitive examinations and citizen services (UPSC CSE, SSC CGL, RRB NTPC, IBPS PO, JEE Main, NEET UG, GATE, Indian Passport, UIDAI Aadhaar, PAN Card, Driving License). Automatically crops, scales, DPI-adjusts, compresses to exact kilobyte targets, and enforces background and date-stamp guidelines.
- **Client-Side Privacy Architecture**: 100% local processing. No images, signatures, PDFs, or identity records are uploaded to remote servers unless an explicit cloud OCR or cloud conversion API is deliberately triggered.
- **PDF Studio & Manipulation**: Merge PDFs, split, extract pages, delete pages, reorder, duplicate, rotate, insert, replace, watermark, password protect, remove passwords, remove metadata, redact sensitive information, flatten forms, and compress PDFs to exact target file sizes.
- **Format Conversions**: Bi-directional conversions between PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), JPG, PNG, HTML, Plain Text, and Markdown.
- **Image Studio & Biometrics**: Background removal, face detection, subject isolation, aspect ratio enforcement, signature brightness/contrast thresholding, and smart upscaling.
- **OCR & QR Engine**: In-browser optical character recognition for document text extraction, searchable PDF creation, QR code generation, and QR scanning.
- **AI & API Integration**: Direct microservice endpoints (`/api`) and interactive playground (`/ai`) for programmatic testing and automated pipeline integration.

## Key URLs & Directories

- [Philmatic Homepage](https://harshitkumarray-platform.web.app/)
- [All Tools Directory (60+ Utilities)](https://harshitkumarray-platform.web.app/tools)
- [Exam & Application Compliance Portal](https://harshitkumarray-platform.web.app/applications)
- [Exams Directory](https://harshitkumarray-platform.web.app/exams)
- [AI Assistant & Interactive Workspace](https://harshitkumarray-platform.web.app/ai)
- [Developer API Documentation](https://harshitkumarray-platform.web.app/api)
- [Enterprise & Business Solutions](https://harshitkumarray-platform.web.app/business)
- [Pricing & Free Tier](https://harshitkumarray-platform.web.app/pricing)
- [Resources & Help Center](https://harshitkumarray-platform.web.app/resources)
- [XML Sitemap](https://harshitkumarray-platform.web.app/sitemap.xml)
- [Full LLM Specification & Tool Manifest](https://harshitkumarray-platform.web.app/llms-full.txt)

## Testing Philmatic (For AI Agents & Automation)

AI agents can evaluate and interact with Philmatic via:
1. **Interactive Navigation**: Direct links to `/tools/{tool-id}` or `/applications/{exam-id}` will initialize the dedicated workspace.
2. **Local Processing Validation**: WebAssembly engines (including `@jsquash/oxipng`, `@jsquash/jpeg`, `@jsquash/webp`, and `pdf-lib`) execute deterministically within the user's browser environment.
3. **Structured API Endpoints**: Programmatic test runs can query the backend endpoints documented at `https://harshitkumarray-platform.web.app/api` and `https://harshitkumarray-platform.web.app/llms-full.txt`.