Skip to main content

ModelForge: A no-code toolkit for fine-tuning HuggingFace models

Project description

ModelForge 🔧⚡

Finetune LLMs on your laptop’s GPU—no code, no PhD, no hassle.

logo

🚀 Features

  • GPU-Powered Finetuning: Optimized for NVIDIA GPUs (even 4GB VRAM).
  • One-Click Workflow: Upload data → Pick task → Train → Test.
  • Hardware-Aware: Auto-detects your GPU/CPU and recommends models.
  • React UI: No CLI or notebooks—just a friendly interface.

📖 Supported Tasks

  • Text-Generation: Generates answers in the form of text based on prior and fine-tuned knowledge. Ideal for use cases like customer support chatbots, story generators, social media script writers, code generators, and general-purpose chatbots.
  • Summarization: Generates summaries for long articles and texts. Ideal for use cases like news article summarization, law document summarization, and medical article summarization.
  • Extractive Question Answering: Finds the answers relevant to a query from a given context. Best for use cases like Retrieval Augmented Generation (RAG), and enterprise document search (for example, searching for information in internal documentation).

Installation

Prerequisites

  • Python==3.11.x: Ensure you have Python installed.
  • NVIDIA GPU: Recommended VRAM >= 6GB.
  • CUDA: Ensure CUDA is installed and configured for your GPU.
  • HuggingFace Account: Create an account on Hugging Face and generate a finegrained access token.

Steps

  1. Install the Package:

    pip install modelforge-finetuning
    
  2. Set HuggingFace API Key in environment variables:
    Linux:

    export HUGGINGFACE_TOKEN=your_huggingface_token
    

    Windows Powershell:

    $env:HUGGINGFACE_TOKEN="your_huggingface_token"
    

    Windows CMD:

    set HUGGINGFACE_TOKEN=your_huggingface_token
    

    Or use a .env file:

    echo "HUGGINGFACE_TOKEN=your_huggingface_token" > .env
    
  3. Install Appropriate CUDA version for PyTorch:

    • Navigate to the PyTorch installation page and select the appropriate CUDA version for your system.
    • Install PyTorch with the correct CUDA version. For example, for CUDA 12.6 on Windows, you can use:
     pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu126
    
  4. Run the Application:

    modelforge run
    
  5. Done!: Navigate to http://localhost:8000 in your browser and get started!

Running the Application Again in the Future

  1. Start the Application:
    modelforge run
    
  2. Navigate to the App:
    Open your browser and go to http://localhost:8000.

Stopping the Application

To stop the application and free up resources, press Ctrl+C in the terminal running the app.

📂 Dataset Format

{"input": "Enter a really long article here...", "output": "Short summary."},
{"input": "Enter the poem topic here...", "output": "Roses are red..."}

🤝 Contributing Model Recommendations

ModelForge uses a modular configuration system for model recommendations. Contributors can easily add new recommended models by adding configuration files to the model_configs/ directory. Each hardware profile (low_end, mid_range, high_end) has its own configuration file where you can specify primary and alternative models for different tasks.

See the Model Configuration Guide for detailed instructions on how to add new model recommendations.

🛠 Tech Stack

  • transformers + peft (LoRA finetuning)
  • bitsandbytes (4-bit quantization)
  • React (UI)
  • FastAPI (Backend)
  • Python (Backend)
  • React.JS (Frontend)

Project details


Download files

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

Source Distribution

modelforge_finetuning-0.2.0.tar.gz (216.8 kB view details)

Uploaded Source

Built Distribution

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

modelforge_finetuning-0.2.0-py3-none-any.whl (233.1 kB view details)

Uploaded Python 3

File details

Details for the file modelforge_finetuning-0.2.0.tar.gz.

File metadata

  • Download URL: modelforge_finetuning-0.2.0.tar.gz
  • Upload date:
  • Size: 216.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for modelforge_finetuning-0.2.0.tar.gz
Algorithm Hash digest
SHA256 122ce6dd75c8bca14235ba1cff2c93ed27cd419c10edb48e1038817ce7aa6cb8
MD5 5393bf852269d6039ad2c9a13795cc38
BLAKE2b-256 8ab5ea2c1b197843c2d7cdd8183239776c09d8b5f420deb6d2107779cec61883

See more details on using hashes here.

Provenance

The following attestation bundles were made for modelforge_finetuning-0.2.0.tar.gz:

Publisher: workflow.yaml on RETR0-OS/ModelForge

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

File details

Details for the file modelforge_finetuning-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for modelforge_finetuning-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d1ff0a46da33baa83ce7a9bd18ff45633df4b97790b87a12cc5f477844a694ee
MD5 c0780e3bb1b639e3f3569a92c693cb86
BLAKE2b-256 2f3abb89d276844fe3e12b2ba6101572ec4d7d8c00162369b8e19db627ac68ff

See more details on using hashes here.

Provenance

The following attestation bundles were made for modelforge_finetuning-0.2.0-py3-none-any.whl:

Publisher: workflow.yaml on RETR0-OS/ModelForge

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