Skip to content

Commit 59871d1

Browse files
committed
doc: update README
1 parent f0b6741 commit 59871d1

File tree

1 file changed

+22
-23
lines changed

1 file changed

+22
-23
lines changed

README.md

Lines changed: 22 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -9,18 +9,18 @@
99
---
1010

1111
## 📑 Table of Contents
12-
- [⚡ Quick Start](#⚡-quick-start-30-seconds)
13-
- [🎯 Project Purpose](#🎯-project-purpose)
14-
- [📁 Project Structure](#📁-project-structure)
15-
- [🛠️ Technical Documentation](#🛠️-technical-documentation)
12+
- [⚡ Quick Start](#quick-start-30-seconds)
13+
- [🎯 Project Purpose](#project-purpose)
14+
- [📁 Project Structure](#project-structure)
15+
- [🛠️ Technical Documentation](#technical-documentation)
1616
- [Setup](#setup)
1717
- [Running Tests](#running-tests)
1818
- [Training & Execution](#training-the-model)
19-
- [🔄 CI/CD & Quality Control](#🔄-cicd--quality-control)
20-
- [🚀 Future & Tech Stack](#🚀-future--tech-stack)
19+
- [🔄 CI/CD & Quality Control](#cicd--quality-control)
20+
- [🚀 Future & Tech Stack](#future--tech-stack)
2121

2222
---
23-
## Quick Start (30 seconds)
23+
## Quick Start (30 seconds)
2424

2525
If you have Docker installed, you can spin up the entire ecosystem with a single command:
2626

@@ -31,7 +31,7 @@ docker compose -f config/docker-compose.yml up --build
3131
* **API:** `http://localhost:5000`
3232
* **UI:** `http://localhost:8501`
3333

34-
## 🎯 Project Purpose
34+
## Project Purpose
3535

3636
This project demonstrates **production-ready MLOps practices** rather than focusing solely on achieving state-of-the-art model performance. The Wisconsin Breast Cancer dataset is used as a **proof-of-concept** to validate the MLOps infrastructure.
3737

@@ -49,7 +49,7 @@ The goal is to showcase best practices in:
4949
5050
This project solves this through container immutability and environment parity.
5151

52-
## 📁 Project Structure
52+
## Project Structure
5353

5454
```text
5555
production-ready-mlops-workflow/
@@ -67,7 +67,7 @@ production-ready-mlops-workflow/
6767
└── pyproject.toml # 📦 Dependency management (uv)
6868
```
6969

70-
## 🛠️ Technical Documentation
70+
## Technical Documentation
7171

7272
### Setup
7373

@@ -225,7 +225,7 @@ This will:
225225
docker compose -f config/docker-compose.yml down
226226
```
227227

228-
## 🔄 CI/CD & Quality Control
228+
## CI/CD & Quality Control
229229

230230
The project implements a continuous integration pipeline that acts as a quality filter (**Quality Gates**):
231231

@@ -254,7 +254,7 @@ The workflow defined in `.github/workflows/main.yml` includes:
254254

255255
This ensures that only tested and validated code reaches production.
256256

257-
## 🚀 Future & Tech Stack
257+
## Future & Tech Stack
258258

259259
<details>
260260
<summary><b>🔮 Future Improvements</b></summary>
@@ -270,17 +270,16 @@ Potential enhancements to further strengthen the MLOps workflow:
270270
<details>
271271
<summary><b>📚 Technologies Used</b></summary>
272272

273-
- **ML Framework**: scikit-learn
274-
- **API Framework**: Flask
275-
- **UI Framework**: Streamlit
276-
- **Validation**: Pydantic
277-
- **Testing**: pytest, pytest-mock
278-
- **Containerization**: Docker, Docker Compose
279-
- **CI/CD**: GitHub Actions
280-
- **Code Quality**: ruff, mypy
281-
- **Dependency Management**: uv
273+
- **ML Stack:** `scikit-learn` (Pipeline & Models), `pandas`, `joblib`.
274+
- **Backend & UI:** `Flask` (Inference API), `Streamlit` (Interactive Dashboard).
275+
- **Modern Tooling:** `uv` (Package Manager), `ruff` (Linter), `mypy` (Type Checking), `pydantic` (Validation).
276+
- **Testing:** `pytest`, `pytest-mock`, `pytest-cov`.
277+
- **Infrastructure:** `Docker`, `Docker Compose`, `GitHub Actions`.
278+
282279
</details>
283280

284-
---
285281

286-
**Remember**: The value of this project is in the **engineering practices**, not the model metrics. These practices ensure your ML models work reliably in production, regardless of the problem domain or dataset complexity.
282+
283+
> This project was developed with ❤️ by [Anibal Rojo](https://github.com/anibalrojosan) as a proof of concept for a real-world MLOps pipeline.
284+
285+
> **Remember**: The value of this project is in the **engineering practices**, not the model metrics. These practices ensure your ML models work reliably in production, regardless of the problem domain or dataset complexity.

0 commit comments

Comments
 (0)