full transparency

README.md

@@ -19,7 +19,13 @@ Here’s a compelling README for your application:
 Welcome to the **Florentine Families Network Analysis Tool**
 - a simple yet powerful prototype designed to analyze the [Florentine family network](https://networkx.org/documentation/stable/reference/generated/networkx.generators.social.florentine_families_graph.html#) using graph-based metrics.
 - integrates **Smolagents**, **Arize Phoenix**, and **NetworkX** to explore the relationships and centrality dynamics of Renaissance-era Florence families.
-- the `app.py` code is a little out of date but I left it `as is` as it showcased where effective telemetry can bring immediate visibility to the impact of minor changes in the tool definition
+
+Full disclosure...
+- the `app.py` code is a little out of date but I left it `as is` as it showcases where effective telemetry can bring immediate visibility to the impact of minor changes in the tool definition
+- based on some disagreements with the SmolAgents GradioUI method I chose to focus on the code generation behavior through telemetry
+  - I also hacked the Gradio implementation a bit so that I could add examples to the UI for more consistent testing
+- I encourage you to run the app locally and get insight to where things are both breaking AND *working properly* using Arize Phoenix -- a powerful learning experience
+- Without Arize Phoenix I would have probably missed how well the combination of Qwen 2.5 Coder *32B* and SmolAgents truly are. (not to mention that even Colab would have challenges running a 32B model)
 
 NOTE: Smolagents has some cool features like [reusable tools](https://huggingface.co/spaces/dwb2023/florentine-families-graph/blob/main/huggingface_spaces_tool_template.md) - but as expected there are some growing pains