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 python license

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)

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:

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 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>):

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

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

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.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for K1lllagt from gravatar.com K1lllagt

Credits

Author: K1LLLAGT

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.9

Provides Extra

images pdf ocr tts yaml markdown cloud pro dev

Tags

file conversion cli pdf image ocr

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyfile_convert-0.1.0.tar.gz (17.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyfile_convert-0.1.0-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

Details for the file pyfile_convert-0.1.0.tar.gz.

File metadata

  • Download URL: pyfile_convert-0.1.0.tar.gz
  • Upload date:
  • Size: 17.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyfile_convert-0.1.0.tar.gz
Algorithm Hash digest
SHA256 620a3685dfbce066236b84c09db54833f7cd5cd3d7ac9490bb983ded15ec5638
MD5 6403e83a80cf25ab4a8f00c71c145122
BLAKE2b-256 6853158810ba0be5c7378a079c9890103e1e30950d265b41432345bc5e6000dd

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyfile_convert-0.1.0.tar.gz:

Publisher: release.yml on K1LLLAGT/File-Forge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pyfile_convert-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: pyfile_convert-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 19.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyfile_convert-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 280e2f8f5aec72eb57babd8b9de53f811bd819301fed6267ca0b3985e5e48649
MD5 516f9dffd86e060babd6dd9880ebf64f
BLAKE2b-256 a55682b6f1815d36f04cbdb1095be201192c2a7d90249e604c3e500dc91da063

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyfile_convert-0.1.0-py3-none-any.whl:

Publisher: release.yml on K1LLLAGT/File-Forge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page