You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Oct 30, 2025. It is now read-only.
Automatically sync and convert Unsloth Colab notebooks to NVIDIA Brev-compatible launchables. This repository provides a production-ready pipeline that:
🧪 Tests all conversions with comprehensive pytest suite
📦 Creates launchables ready to deploy on NVIDIA Brev
📋 What This Does
This adapter transforms Unsloth Colab notebooks for seamless use on NVIDIA Brev by:
Installation Conversion - Replaces unsloth[colab-new] with unsloth[conda]
Magic Commands - Converts ! and % commands to subprocess calls
Storage Adaptation - Removes Google Drive mounting, updates paths to /workspace/
GPU Configuration - Adds device_map="auto" for multi-GPU support
Batch Size Optimization - Adjusts batch sizes for NVIDIA GPUs
Companion Files - Generates setup scripts, Docker configs, and documentation
📒 Available Launchables
Below are 181 Unsloth notebooks organized into 129 launchables for NVIDIA Brev, categorized by model type. Each notebook is fully adapted for Brev environments with GPU-optimized configurations, companion files, and ready-to-run setups.
Path: converted/{model-name} (see table above for exact model names)
GPU Tier: Use recommended tier from table above
Port: 8888 (for Jupyter Lab)
Deploy: Click Deploy and access Jupyter at the provided URL
All converted notebooks include:
Original notebook file (.ipynb) - Main training notebook
requirements.txt - Python dependencies
setup.sh - Environment setup script
docker-compose.yml - Local Docker configuration
README.md - Model-specific documentation
.brevconfig.json - Brev metadata
🎯 Quick Start for Users
Deploy on Brev Console
# Browse available launchables
ls converted/
# Launch a specific model (example)cd converted/llama-3.1-8b-fine-tuning
cat README.md # View instructions# Or use with Docker
docker-compose up
All converted notebooks are in the converted/ directory, organized by model name.
🛠️ Quick Start for Contributors
Local Setup
Important: Use a virtual environment to avoid system package conflicts (especially on macOS).
# Clone the repository
git clone git@github.com:brevdev/unsloth-notebook-adaptor.git
cd unsloth-notebook-adaptor
# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate# Install dependencies
pip install -r requirements.txt
# Run tests
pytest tests/ -v
# Run all tests
pytest tests/ -v
# Run with coverage
pytest tests/ --cov=adapters --cov-report=term --cov-report=html
# Run specific test file
pytest tests/test_conversions.py -v
# Run specific test
pytest tests/test_conversions.py::test_convert_installation -v
# Create a feature branch
git checkout -b feature/my-improvement
# Make changes and test
pytest tests/ -v
# Commit with conventional commits
git commit -m "feat: add support for new model"# Push and create PR
git push origin feature/my-improvement
📊 Metadata Registry
The metadata/launchables.json file contains a complete registry of all converted launchables:
