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
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.

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:
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 server video 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.1.tar.gz (23.9 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.1-py3-none-any.whl (24.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pyfile_convert-0.1.1.tar.gz
  • Upload date:
  • Size: 23.9 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.1.tar.gz
Algorithm Hash digest
SHA256 3b7af7a166fa6ed54547ba7b2eedf8601e60d3f42c35d726e488b93a7f639cb5
MD5 cbd237c6ad16fa22f006fb319844c061
BLAKE2b-256 300e2faf43a76f71905978ec73f59d3f3fe62f90cf86214785552779f9fb0948

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: pyfile_convert-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 24.5 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c953f133bf519cb933272cb0e0addbbb8912e0db125063a7d2f36d74050a3df4
MD5 bcd401c5babc4071f0ceb32c8a5c9073
BLAKE2b-256 72ed3455d551c857dc1318be835a7ec0f5dc964568430a9e4cd7f731dd1268bf

See more details on using hashes here.

Provenance

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