Metadata-Version: 2.4
Name: pyfile-convert
Version: 0.1.0
Summary: FileForge — a multi-tier file-conversion toolkit (CLI free tier).
Author: K1LLLAGT
License: MIT
Project-URL: Homepage, https://github.com/K1LLLAGT/File-Forge
Project-URL: Repository, https://github.com/K1LLLAGT/File-Forge
Keywords: file,conversion,cli,pdf,image,ocr
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: images
Requires-Dist: Pillow>=10.0; extra == "images"
Provides-Extra: pdf
Requires-Dist: pypdf>=4.0; extra == "pdf"
Provides-Extra: ocr
Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
Requires-Dist: Pillow>=10.0; extra == "ocr"
Provides-Extra: tts
Requires-Dist: pyttsx3>=2.90; extra == "tts"
Provides-Extra: yaml
Requires-Dist: PyYAML>=6.0; extra == "yaml"
Provides-Extra: markdown
Requires-Dist: markdown>=3.5; extra == "markdown"
Provides-Extra: cloud
Requires-Dist: fastapi>=0.110; extra == "cloud"
Requires-Dist: uvicorn>=0.29; extra == "cloud"
Requires-Dist: python-multipart>=0.0.9; extra == "cloud"
Provides-Extra: pro
Requires-Dist: Pillow>=10.0; extra == "pro"
Requires-Dist: pypdf>=4.0; extra == "pro"
Requires-Dist: pytesseract>=0.3.10; extra == "pro"
Requires-Dist: pyttsx3>=2.90; extra == "pro"
Requires-Dist: PyYAML>=6.0; extra == "pro"
Requires-Dist: markdown>=3.5; extra == "pro"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Dynamic: license-file

# FileForge

**A multi-tier file-conversion product ecosystem** — one shared engine powering
a free CLI, a Pro desktop/Android build, a Cloud API, and Enterprise licensing.

![status](https://img.shields.io/badge/status-active-brightgreen)
![python](https://img.shields.io/badge/python-3.9%2B-blue)
![license](https://img.shields.io/badge/license-MIT%20(core)-green)

> The free CLI is fully functional and MIT-licensed. Pro / Cloud / Enterprise
> features unlock over the **same engine** with a license key.

---

## Quick start (free CLI)

```bash
pip install -e .            # or: pip install pyfile-convert  (once published)
fileforge list             # show conversions available to your tier
fileforge convert notes.md notes.html
fileforge convert data.json data.csv
fileforge convert report.txt report.pdf     # pure-Python PDF, no deps
```

Optional accelerators:

```bash
pip install -e '.[images]'   # PNG/JPG/WEBP/... via Pillow
pip install -e '.[pdf]'      # PDF merge/split (Pro)
pip install -e '.[ocr]'      # Tesseract OCR (Pro)
pip install -e '.[cloud]'    # run the Cloud API locally
```

## What's in the box

| Path                | Tier / Strategy                    | What it is                                   |
|---------------------|------------------------------------|----------------------------------------------|
| `src/fileforge/`    | Free CLI + shared engine           | Conversion registry, converters, licensing   |
| `src/fileforge/pro/`| Pro (batch, OCR, PDF, TTS)         | License-gated advanced features              |
| `cloud-api/`        | Strategy 3 & 7 — Cloud API         | FastAPI convert/formats/usage + metering     |
| `desktop/`          | Strategy 6 — Desktop GUI           | Tkinter reference GUI (PyQt/Electron in Pro) |
| `android/`          | Strategy 2 — Android GUI           | Compose + Chaquopy architecture & skeleton   |
| `magisk-module/`    | Strategy 9 — Magisk module         | Flashable system-wide install                |
| `scripts/`          | Fulfillment / packaging            | License issuing, Magisk zip builder          |
| `docs/monetization-plan.md` | Business document          | Full 10-strategy monetization & roadmap      |

## Tiers

| Tier           | Package                                      |
|----------------|----------------------------------------------|
| **Free**       | CLI tool                                     |
| **Pro**        | Advanced features, GUI, automation, cloud    |
| **Enterprise** | Licensing, API access, support, custom builds|

See **[docs/monetization-plan.md](docs/monetization-plan.md)** for the complete
pricing, feature matrix, distribution, marketing, revenue projections, and
six-month execution roadmap.

## Licensing model (technical)

Features gate on offline, HMAC-signed keys (`FF-<TIER>-<SUBJECT>-<SIG>`):

```bash
export FILEFORGE_LICENSE="$(python scripts/issue_license.py --tier pro --subject demo)"
fileforge batch ./images png jpg --recursive --workers 8   # Pro unlocked
```

Without a key everything runs at the **Free** tier. Keys are minted from a
purchase webhook (Gumroad/Payhip) in production.

## Run the Cloud API locally

```bash
pip install -e '.[cloud]'
cd cloud-api && uvicorn app.main:app --reload
# POST a file:
curl -s -H 'X-API-Key: demo-lifetime' \
     -F file=@notes.md 'http://127.0.0.1:8000/v1/convert?target=html' -o out.html
```

## Development

```bash
pip install -e '.[dev]'
pytest -q
```

## License

Core engine and CLI: **MIT** (see `LICENSE`). Pro/Cloud/Enterprise builds and
assets are commercial; see the monetization plan.
