Sarah Glasmacher
Sarah Glasmacher
my journey through ML and studies
⌘K
Subscribe Sign in
members-only post ML Ops

Your ML Repo Starter Kit: src Layout, uv venv, GitHub Push

Sarah Glasmacher

by Sarah Glasmacher

Your ML Repo Starter Kit: src Layout, uv venv, GitHub Push

Let's start building an organized repository for our ML Blueprint Project 😊 This is the initial step in the larger ML Blueprint challenge, where we will professionalize a notebook-only project step-by-step into a testable, modular structure with clear configuration, development, and deployment parts.

Most ML ideas start life in a notebook. Some even grow up there. But if you’ve ever tried to take a promising experiment from your laptop - or even worse, from another developer's laptop - to another environment, you know the pain: missing dependencies, mystery settings, scattered scripts, and plots living in five different folders. Today, we fix that by giving your project a simple, professional backbone you can build on.

By the end of this step, you’ll have:

  • a minimal-but-solid repo structure you can reuse,
  • a reproducible environment managed with uv,
  • your package importable from scripts/notebooks,
  • a first dataset wired in for quick iteration,
  • and your initial commit live on GitHub.
This post is for subscribers only

Subscribe to continue reading


More like this

🚀 Ready to Finally Upgrade from messy ML notebooks? Setup to Shipping Challenge

🚀 Ready to Finally Upgrade from messy ML notebooks? Setup to Shipping Challenge

Tired of hard-to-maintain ML code? Join me on the 4-week ML Project Blueprint Challenge and turn a blank repo into a clean, configurable, and shippable ML project.
How I Set Up a Machine Learning Project with `uv` and `pyproject.toml`

How I Set Up a Machine Learning Project with `uv` and `pyproject.toml`

One of the biggest challenges in machine learning is ensuring that an experiment can be reliably reproduced. Of course, this
Using Taskfile with uv and pyproject.toml to manage your Python Machine Learning projects

Using Taskfile with uv and pyproject.toml to manage your Python Machine Learning projects

"Use uv to manage your Python projects" is not a new take anymore, but have you tried Taskfile?
“Side-by-side comparison of a disorganized ML project folder and a refactored version using the Python src/ layout”

Adding a src/ Folder to an Existing ML Project: Step-by-Step Guide

So you already created a repository for your ML project, but now you want a better way to organize your
What is MLflow model logging and when do I use which logging method?

What is MLflow model logging and when do I use which logging method?

If you’ve trained a machine learning model and thought “Wow, this one is actually good!”, only to realize a
How to set up pgvector with Docker: Local Vector Database for Text Embeddings

How to set up pgvector with Docker: Local Vector Database for Text Embeddings

In this post, I'll walk you through how I set up a local vector storage system using pgvector,