From 0e9733d5706ffa453c46cdfc0f73179b67fb1e7d Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Tue, 19 May 2026 17:36:32 -0400 Subject: [PATCH 01/14] Create README.md --- profile/README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 profile/README.md diff --git a/profile/README.md b/profile/README.md new file mode 100644 index 0000000..a8c2324 --- /dev/null +++ b/profile/README.md @@ -0,0 +1,45 @@ +Mellea logo + +# Mellea — build predictable AI without guesswork + +Inside every AI-powered pipeline, the unreliable part is the same: the LLM call itself. +Silent failures, untestable outputs, no guarantees. +Mellea is a Python library for writing *generative programs* — replacing brittle prompts and flaky agents +with structured, testable AI workflows built around type-annotated outputs, verifiable requirements, and automatic retries. + +Skip to: +* [Code](#latest-projects) +* [Tools](#tools) +* [Documentation](https://docs.mellea.ai/) + +## Latest Projects +* Mellea +* Granite Switch +* Mellea Skills Compiler +* mellea-contribs + +## Tools + +1. [Installation](https://docs.mellea.ai/getting-started/installation) +2. [Quick Start](https://docs.mellea.ai/getting-started/quickstart) +3. [API Reference](https://docs.mellea.ai/api-reference) + +## Documentation + +The general Mellea [Documentation](https://docs.mellea.ai/) is updated regularly. + +**Learning Resources** provide in-depth educational material in comprehensive formats. + +- [Mellea Examples](https://github.com/generative-computing/mellea/tree/main/docs/examples) - comprehensive examples demonstrating Mellea's features and capabilities. +[Mellea Demos](https://github.com/generative-computing/mellea-demos) - A collection of Mellea demos. +- [Mellea Tutorials](https://github.com/generative-computing/mellea-tutorials) - Long-form workshops and tutorials for Mellea. The main Mellea repo keeps its examples short and focused; the notebooks here have more room to walk through end-to-end workflows, conference material, and exploratory demos. + +## Other Resources +- [Mellea Website:](https://mellea.ai/) More information about Mellea. +- [Blog:](https://mellea.ai/blogs/) Deep-dives on agentic systems, generative computing, and the ideas behind Mellea. +- [Mellea on PyPI:](https://pypi.org/project/mellea/) The Mellea organization on PyPI. You can download Mellea there. + + +## Discussion + +If you have any questions, please visit our [discussions page](https://github.com/generative-computing/mellea/discussions). From 7bfab620822ba29702e2e87abd1b567dbd623304 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Wed, 20 May 2026 11:50:16 -0400 Subject: [PATCH 02/14] Change from code to projects Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index a8c2324..65490be 100644 --- a/profile/README.md +++ b/profile/README.md @@ -8,7 +8,7 @@ Mellea is a Python library for writing *generative programs* — replacing britt with structured, testable AI workflows built around type-annotated outputs, verifiable requirements, and automatic retries. Skip to: -* [Code](#latest-projects) +* [Projects](#latest-projects) * [Tools](#tools) * [Documentation](https://docs.mellea.ai/) From d839c45c13d67d08a6ad360f7d5c9a4aa0a9a2c7 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Wed, 20 May 2026 16:32:14 -0400 Subject: [PATCH 03/14] getting started Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 65490be..4dc2c33 100644 --- a/profile/README.md +++ b/profile/README.md @@ -9,7 +9,7 @@ with structured, testable AI workflows built around type-annotated outputs, veri Skip to: * [Projects](#latest-projects) -* [Tools](#tools) +* [Getting Started](#getting-started) * [Documentation](https://docs.mellea.ai/) ## Latest Projects From dea1035ab5ed1ae5928ec950c08b22bd1baaae90 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Wed, 20 May 2026 16:32:34 -0400 Subject: [PATCH 04/14] change anchors Co-authored-by: Alex Bozarth --- profile/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/profile/README.md b/profile/README.md index 4dc2c33..63a5913 100644 --- a/profile/README.md +++ b/profile/README.md @@ -13,10 +13,10 @@ Skip to: * [Documentation](https://docs.mellea.ai/) ## Latest Projects -* Mellea -* Granite Switch -* Mellea Skills Compiler -* mellea-contribs +* [Mellea](https://github.com/generative-computing/mellea) +* [Granite Switch](https://github.com/generative-computing/granite-switch) +* [Mellea Skills Compiler](https://github.com/generative-computing/mellea-skills-compiler) +* [mellea-contribs](https://github.com/generative-computing/mellea-contribs) ## Tools From a9b31d9473ccf2950f9c2fcb0612d384f0ef3d77 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Wed, 20 May 2026 16:32:52 -0400 Subject: [PATCH 05/14] getting started header Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 63a5913..72f21c0 100644 --- a/profile/README.md +++ b/profile/README.md @@ -18,7 +18,7 @@ Skip to: * [Mellea Skills Compiler](https://github.com/generative-computing/mellea-skills-compiler) * [mellea-contribs](https://github.com/generative-computing/mellea-contribs) -## Tools +## Getting Started 1. [Installation](https://docs.mellea.ai/getting-started/installation) 2. [Quick Start](https://docs.mellea.ai/getting-started/quickstart) From a03f1da150ec314906d75b5b0e17390f5720ae1f Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Wed, 20 May 2026 16:33:19 -0400 Subject: [PATCH 06/14] fix typo Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 72f21c0..97181f7 100644 --- a/profile/README.md +++ b/profile/README.md @@ -31,7 +31,7 @@ The general Mellea [Documentation](https://docs.mellea.ai/) is updated regularly **Learning Resources** provide in-depth educational material in comprehensive formats. - [Mellea Examples](https://github.com/generative-computing/mellea/tree/main/docs/examples) - comprehensive examples demonstrating Mellea's features and capabilities. -[Mellea Demos](https://github.com/generative-computing/mellea-demos) - A collection of Mellea demos. +- [Mellea Demos](https://github.com/generative-computing/mellea-demos) - A collection of Mellea demos. - [Mellea Tutorials](https://github.com/generative-computing/mellea-tutorials) - Long-form workshops and tutorials for Mellea. The main Mellea repo keeps its examples short and focused; the notebooks here have more room to walk through end-to-end workflows, conference material, and exploratory demos. ## Other Resources From e438cb310650ccb4423012b7cf8ce877f748fdab Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Wed, 20 May 2026 16:33:36 -0400 Subject: [PATCH 07/14] move : Co-authored-by: Alex Bozarth --- profile/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/profile/README.md b/profile/README.md index 97181f7..49b0858 100644 --- a/profile/README.md +++ b/profile/README.md @@ -35,9 +35,9 @@ The general Mellea [Documentation](https://docs.mellea.ai/) is updated regularly - [Mellea Tutorials](https://github.com/generative-computing/mellea-tutorials) - Long-form workshops and tutorials for Mellea. The main Mellea repo keeps its examples short and focused; the notebooks here have more room to walk through end-to-end workflows, conference material, and exploratory demos. ## Other Resources -- [Mellea Website:](https://mellea.ai/) More information about Mellea. -- [Blog:](https://mellea.ai/blogs/) Deep-dives on agentic systems, generative computing, and the ideas behind Mellea. -- [Mellea on PyPI:](https://pypi.org/project/mellea/) The Mellea organization on PyPI. You can download Mellea there. +- [Mellea Website](https://mellea.ai/): More information about Mellea. +- [Blog](https://mellea.ai/blogs/): Deep-dives on agentic systems, generative computing, and the ideas behind Mellea. +- [Mellea on PyPI](https://pypi.org/project/mellea/): The Mellea organization on PyPI. You can download Mellea there. ## Discussion From 924d91b1e5d5f591328653c8bac432c6d0d5c345 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Wed, 20 May 2026 16:59:33 -0400 Subject: [PATCH 08/14] update to anchor Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 49b0858..44f8458 100644 --- a/profile/README.md +++ b/profile/README.md @@ -10,7 +10,7 @@ with structured, testable AI workflows built around type-annotated outputs, veri Skip to: * [Projects](#latest-projects) * [Getting Started](#getting-started) -* [Documentation](https://docs.mellea.ai/) +* [Documentation](#documentation) ## Latest Projects * [Mellea](https://github.com/generative-computing/mellea) From 8858565c448a47707c6257d0b85958f6b2d22789 Mon Sep 17 00:00:00 2001 From: Abraham Daniels <66644823+abrahamdaniels@users.noreply.github.com> Date: Wed, 20 May 2026 21:17:24 -0400 Subject: [PATCH 09/14] Update README.md - Removed "inside every." - Removed 'No guarantees.' with 'Unpredictable behavior.' -- I wanted to stay away from the word guarantee as it's a bit too strong --- profile/README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/profile/README.md b/profile/README.md index 44f8458..2cf9ddc 100644 --- a/profile/README.md +++ b/profile/README.md @@ -2,8 +2,10 @@ # Mellea — build predictable AI without guesswork -Inside every AI-powered pipeline, the unreliable part is the same: the LLM call itself. -Silent failures, untestable outputs, no guarantees. +**The problem with AI pipelines is always the same: the LLM itself** + +Silent failures. untestable outputs. Unpredictable behavior + Mellea is a Python library for writing *generative programs* — replacing brittle prompts and flaky agents with structured, testable AI workflows built around type-annotated outputs, verifiable requirements, and automatic retries. From 5a9e324c1faf62ed3ae9691d41ad1807fb4e6da4 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Thu, 21 May 2026 13:23:35 -0400 Subject: [PATCH 10/14] Added period to Mellea description Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 2cf9ddc..6341c67 100644 --- a/profile/README.md +++ b/profile/README.md @@ -2,7 +2,7 @@ # Mellea — build predictable AI without guesswork -**The problem with AI pipelines is always the same: the LLM itself** +**The problem with AI pipelines is always the same: the LLM itself.** Silent failures. untestable outputs. Unpredictable behavior From f8cf10553423f8cdd5a8f3dbeb43e0a59cf8c406 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Thu, 21 May 2026 13:23:55 -0400 Subject: [PATCH 11/14] Capitalization and trailing period Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 6341c67..965e82a 100644 --- a/profile/README.md +++ b/profile/README.md @@ -4,7 +4,7 @@ **The problem with AI pipelines is always the same: the LLM itself.** -Silent failures. untestable outputs. Unpredictable behavior +Silent failures. Untestable outputs. Unpredictable behavior. Mellea is a Python library for writing *generative programs* — replacing brittle prompts and flaky agents with structured, testable AI workflows built around type-annotated outputs, verifiable requirements, and automatic retries. From ce13e1a6a057ff74b74fbe3de1ef399d9ac94d76 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Thu, 21 May 2026 13:24:21 -0400 Subject: [PATCH 12/14] Drop anchors Co-authored-by: Alex Bozarth --- profile/README.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/profile/README.md b/profile/README.md index 965e82a..41a0eee 100644 --- a/profile/README.md +++ b/profile/README.md @@ -9,11 +9,6 @@ Silent failures. Untestable outputs. Unpredictable behavior. Mellea is a Python library for writing *generative programs* — replacing brittle prompts and flaky agents with structured, testable AI workflows built around type-annotated outputs, verifiable requirements, and automatic retries. -Skip to: -* [Projects](#latest-projects) -* [Getting Started](#getting-started) -* [Documentation](#documentation) - ## Latest Projects * [Mellea](https://github.com/generative-computing/mellea) * [Granite Switch](https://github.com/generative-computing/granite-switch) From ca8ceaea2c575ff20f4c6bf9cd5900ad2349e002 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Thu, 21 May 2026 13:24:47 -0400 Subject: [PATCH 13/14] Streamine blurb on examples Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 41a0eee..4d9dbbf 100644 --- a/profile/README.md +++ b/profile/README.md @@ -27,7 +27,7 @@ The general Mellea [Documentation](https://docs.mellea.ai/) is updated regularly **Learning Resources** provide in-depth educational material in comprehensive formats. -- [Mellea Examples](https://github.com/generative-computing/mellea/tree/main/docs/examples) - comprehensive examples demonstrating Mellea's features and capabilities. +- [Mellea Examples](https://github.com/generative-computing/mellea/tree/main/docs/examples) - examples demonstrating Mellea's features. - [Mellea Demos](https://github.com/generative-computing/mellea-demos) - A collection of Mellea demos. - [Mellea Tutorials](https://github.com/generative-computing/mellea-tutorials) - Long-form workshops and tutorials for Mellea. The main Mellea repo keeps its examples short and focused; the notebooks here have more room to walk through end-to-end workflows, conference material, and exploratory demos. From 0f963a09cc88e37314a6fa295d26166e530f0317 Mon Sep 17 00:00:00 2001 From: Mo McElaney Date: Thu, 21 May 2026 13:25:13 -0400 Subject: [PATCH 14/14] Improve PyPI description Co-authored-by: Alex Bozarth --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 4d9dbbf..0758e56 100644 --- a/profile/README.md +++ b/profile/README.md @@ -34,7 +34,7 @@ The general Mellea [Documentation](https://docs.mellea.ai/) is updated regularly ## Other Resources - [Mellea Website](https://mellea.ai/): More information about Mellea. - [Blog](https://mellea.ai/blogs/): Deep-dives on agentic systems, generative computing, and the ideas behind Mellea. -- [Mellea on PyPI](https://pypi.org/project/mellea/): The Mellea organization on PyPI. You can download Mellea there. +- [Mellea on PyPI](https://pypi.org/project/mellea/): Install with `pip install mellea`. ## Discussion