Skip to content

One-line install: make leap-finetune pip/uv installable from PyPI#18

Closed
Paulescu wants to merge 1 commit intomainfrom
feature/one-line-install
Closed

One-line install: make leap-finetune pip/uv installable from PyPI#18
Paulescu wants to merge 1 commit intomainfrom
feature/one-line-install

Conversation

@Paulescu
Copy link
Copy Markdown
Contributor

The problem

Right now, trying out leap-finetune requires four commands before you can even run a training job:

curl -LsSf https://astral.sh/uv/install.sh | sh
git clone <repo>
cd leap-finetune
uv sync

Requiring a git clone signals this is a research repo, not a production-ready tool. Developers evaluating it will bounce off this friction before they ever run anything.

The goal

Reduce this to one command, for both pip and uv users:

pip install leap-finetune
# or
uv tool install leap-finetune

Why it matters for adoption

Every comparable tool in this space (trl, axolotl, unsloth, litgpt) is one-line installable from PyPI. Users expect this. Without a PyPI listing we also get zero organic discoverability. The fix is low-effort (three small file changes) with high upside.

What this PR contains

A detailed proposal (PROPOSAL_one_line_install.md) describing the three targeted changes needed:

  1. Move job_configs/ inside the package so it travels with the installed wheel.
  2. Fix constants.py to use importlib.resources instead of walking up from __file__.
  3. Update config_resolver.py to find bundled configs via importlib.resources.

The actual implementation is a follow-up. This PR is intended to align the team on the approach before we write any code.

What stays the same

The clone-and-run developer workflow is completely unaffected. Config resolution checks local paths first, so existing contributors see no change.

See PROPOSAL_one_line_install.md for the full cost-benefit breakdown and details.

Outlines the three targeted changes needed to make `leap-finetune`
installable with a single `pip install` or `uv tool install`, removing
the current git clone requirement and lowering the barrier to adoption.
@alay2shah alay2shah closed this Mar 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants