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; import/command stay `fileforge`)
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

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.

Everything is free

FileForge is completely free — every feature (batch, parallel processing, OCR, PDF merge/split, video presets, TTS) is available to everyone with no license required:

fileforge batch ./images png jpg --recursive --workers 8
fileforge video clip.mov out.mp4 --preset web-720p

The Ed25519 licensing system and the license server are kept in the repo but dormant — licensing.require() is a no-op, so nothing is gated. If you ever want to reintroduce paid tiers, restore the tier check in src/fileforge/licensing.py (the original code is preserved in a comment there) and re-enable the license-server/.

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:
Latest release

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 xml toml xlsx cloud server video pro all dev

Tags

file conversion cli pdf image ocr toml xml xlsx

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.2.tar.gz (27.6 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.2-py3-none-any.whl (29.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pyfile_convert-0.1.2.tar.gz
  • Upload date:
  • Size: 27.6 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.2.tar.gz
Algorithm Hash digest
SHA256 834f6d14f42afba0af0da394546dad549846c5ceb936e8c099ef02c112934a9a
MD5 17ce6ffb2b07a7b5656a1ef7474f6d3e
BLAKE2b-256 46e13f7f3e15bf5b6b363c5b29a85e8c706bf36145055a22e7afa298a9d23b11

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyfile_convert-0.1.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: pyfile_convert-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 29.6 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 72a9074b07ce90bda902de90ec187f6e02063b6ee2d08bed6ab9c82e80d499a6
MD5 7d5a4ff55d0bc02039bda9ce415db51d
BLAKE2b-256 eeeeba682f1195f2d7e3e79d556533160ecae9fb5962267fbf23e816f77fab2c

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyfile_convert-0.1.2-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