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.1.tar.gz (218.6 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.1-py3-none-any.whl (235.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: modelforge_finetuning-0.2.1.tar.gz
  • Upload date:
  • Size: 218.6 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.1.tar.gz
Algorithm Hash digest
SHA256 ea9f3d123c302202129cc17c450872209f88807815ff8e01ab54e65cede128d1
MD5 8d34b3987be2e507b6a295e54e324fcc
BLAKE2b-256 62bdc2930bb6497d41d782642c7573295cce3527ac815cc0ef9dbcd700be76cd

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for modelforge_finetuning-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bd04e03361149aa771abab33727fb5abd1d4179d14a0a09e22ab0e2c1500c15c
MD5 9cfc8d3bbda0dd74877bef9c4fca3aec
BLAKE2b-256 2720b3c8462366ee0ce5cc19acf271a2c02b23ff060baeed238730b85962f1ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for modelforge_finetuning-0.2.1-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