cfahlgren1 HF staff commited on
Commit
3cd2f54
1 Parent(s): 68b221c

add model tree example

Browse files
Files changed (4) hide show
  1. .gitignore +2 -0
  2. README.md +3 -3
  3. app.py +69 -422
  4. requirements.txt +43 -5
.gitignore ADDED
@@ -0,0 +1,2 @@
 
 
 
1
+ venv/
2
+ *.pyc
README.md CHANGED
@@ -1,12 +1,12 @@
1
  ---
2
- title: Qwen Derived Models
3
- emoji: 🍃
4
  colorFrom: indigo
5
  colorTo: purple
6
  sdk: docker
7
  pinned: true
8
  license: mit
9
- short_description: Template for deploying a marimo application to HF
10
  ---
11
 
12
  Check out marimo at <https://github.com/marimo-team/marimo>
 
1
  ---
2
+ title: Hub Model Tree Stats
3
+ emoji: 🌴
4
  colorFrom: indigo
5
  colorTo: purple
6
  sdk: docker
7
  pinned: true
8
  license: mit
9
+ short_description: Get aggregated stats about derived models for an organization or author.
10
  ---
11
 
12
  Check out marimo at <https://github.com/marimo-team/marimo>
app.py CHANGED
@@ -1,470 +1,117 @@
1
  import marimo
2
 
3
- __generated_with = "0.9.2"
4
- app = marimo.App()
5
 
6
 
7
- @app.cell
8
  def __():
9
  import marimo as mo
 
 
 
 
 
10
 
11
- mo.md("# Welcome to marimo! 🌊🍃")
12
- return (mo,)
13
-
14
-
15
- @app.cell
16
- def __(mo):
17
- slider = mo.ui.slider(1, 22)
18
- return (slider,)
19
-
20
-
21
- @app.cell
22
- def __(mo, slider):
23
- mo.md(
24
- f"""
25
- marimo is a **reactive** Python notebook.
26
-
27
- This means that unlike traditional notebooks, marimo notebooks **run
28
- automatically** when you modify them or
29
- interact with UI elements, like this slider: {slider}.
30
-
31
- {"##" + "🍃" * slider.value}
32
- """
33
- )
34
- return
35
-
36
-
37
- @app.cell(hide_code=True)
38
- def __(mo):
39
- mo.accordion(
40
- {
41
- "Tip: disabling automatic execution": mo.md(
42
- rf"""
43
- marimo lets you disable automatic execution: just go into the
44
- notebook settings and set
45
-
46
- "Runtime > On Cell Change" to "lazy".
47
-
48
- When the runtime is lazy, after running a cell, marimo marks its
49
- descendants as stale instead of automatically running them. The
50
- lazy runtime puts you in control over when cells are run, while
51
- still giving guarantees about the notebook state.
52
- """
53
- )
54
- }
55
- )
56
- return
57
 
58
 
59
  @app.cell(hide_code=True)
60
  def __(mo):
61
- mo.md(
62
- """
63
- Tip: This is a tutorial notebook. You can create your own notebooks
64
- by entering `marimo edit` at the command line.
65
- """
66
- ).callout()
67
- return
68
-
69
-
70
- @app.cell(hide_code=True)
71
- def __(mo):
72
- mo.md(
73
- """
74
- ## 1. Reactive execution
75
-
76
- A marimo notebook is made up of small blocks of Python code called
77
- cells.
78
-
79
- marimo reads your cells and models the dependencies among them: whenever
80
- a cell that defines a global variable is run, marimo
81
- **automatically runs** all cells that reference that variable.
82
-
83
- Reactivity keeps your program state and outputs in sync with your code,
84
- making for a dynamic programming environment that prevents bugs before they
85
- happen.
86
- """
87
- )
88
- return
89
-
90
-
91
- @app.cell(hide_code=True)
92
- def __(changed, mo):
93
- (
94
- mo.md(
95
- f"""
96
- **✨ Nice!** The value of `changed` is now {changed}.
97
-
98
- When you updated the value of the variable `changed`, marimo
99
- **reacted** by running this cell automatically, because this cell
100
- references the global variable `changed`.
101
-
102
- Reactivity ensures that your notebook state is always
103
- consistent, which is crucial for doing good science; it's also what
104
- enables marimo notebooks to double as tools and apps.
105
- """
106
- )
107
- if changed
108
- else mo.md(
109
- """
110
- **🌊 See it in action.** In the next cell, change the value of the
111
- variable `changed` to `True`, then click the run button.
112
- """
113
- )
114
- )
115
  return
116
 
117
 
118
  @app.cell
119
- def __():
120
- changed = False
121
- return (changed,)
122
 
123
 
124
  @app.cell(hide_code=True)
125
  def __(mo):
126
- mo.accordion(
127
- {
128
- "Tip: execution order": (
129
- """
130
- The order of cells on the page has no bearing on
131
- the order in which cells are executed: marimo knows that a cell
132
- reading a variable must run after the cell that defines it. This
133
- frees you to organize your code in the way that makes the most
134
- sense for you.
135
- """
136
- )
137
- }
138
- )
139
- return
140
-
141
 
142
- @app.cell(hide_code=True)
143
- def __(mo):
144
- mo.md(
145
- """
146
- **Global names must be unique.** To enable reactivity, marimo imposes a
147
- constraint on how names appear in cells: no two cells may define the same
148
- variable.
149
- """
 
 
 
150
  )
151
- return
152
-
153
-
154
- @app.cell(hide_code=True)
155
- def __(mo):
156
- mo.accordion(
157
- {
158
- "Tip: encapsulation": (
159
- """
160
- By encapsulating logic in functions, classes, or Python modules,
161
- you can minimize the number of global variables in your notebook.
162
- """
163
- )
164
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
165
  )
166
- return
167
-
168
-
169
- @app.cell(hide_code=True)
170
- def __(mo):
171
- mo.accordion(
172
- {
173
- "Tip: private variables": (
174
- """
175
- Variables prefixed with an underscore are "private" to a cell, so
176
- they can be defined by multiple cells.
177
- """
178
- )
179
- }
180
- )
181
- return
182
-
183
-
184
- @app.cell(hide_code=True)
185
- def __(mo):
186
- mo.md(
187
- """
188
- ## 2. UI elements
189
-
190
- Cells can output interactive UI elements. Interacting with a UI
191
- element **automatically triggers notebook execution**: when
192
- you interact with a UI element, its value is sent back to Python, and
193
- every cell that references that element is re-run.
194
-
195
- marimo provides a library of UI elements to choose from under
196
- `marimo.ui`.
197
- """
198
- )
199
- return
200
-
201
-
202
- @app.cell
203
- def __(mo):
204
- mo.md("""**🌊 Some UI elements.** Try interacting with the below elements.""")
205
- return
206
 
207
 
208
  @app.cell
209
  def __(mo):
210
- icon = mo.ui.dropdown(["🍃", "🌊", "✨"], value="🍃")
211
- return (icon,)
212
-
213
-
214
- @app.cell
215
- def __(icon, mo):
216
- repetitions = mo.ui.slider(1, 16, label=f"number of {icon.value}: ")
217
- return (repetitions,)
218
-
219
-
220
- @app.cell
221
- def __(icon, repetitions):
222
- icon, repetitions
223
- return
224
-
225
-
226
- @app.cell
227
- def __(icon, mo, repetitions):
228
- mo.md("# " + icon.value * repetitions.value)
229
  return
230
 
231
 
232
  @app.cell(hide_code=True)
233
- def __(mo):
234
- mo.md(
235
- """
236
- ## 3. marimo is just Python
237
-
238
- marimo cells parse Python (and only Python), and marimo notebooks are
239
- stored as pure Python files — outputs are _not_ included. There's no
240
- magical syntax.
241
-
242
- The Python files generated by marimo are:
243
-
244
- - easily versioned with git, yielding minimal diffs
245
- - legible for both humans and machines
246
- - formattable using your tool of choice,
247
- - usable as Python scripts, with UI elements taking their default
248
- values, and
249
- - importable by other modules (more on that in the future).
250
- """
251
- )
252
  return
253
 
254
 
255
  @app.cell(hide_code=True)
256
- def __(mo):
257
- mo.md(
258
- """
259
- ## 4. Running notebooks as apps
260
-
261
- marimo notebooks can double as apps. Click the app window icon in the
262
- bottom-right to see this notebook in "app view."
263
-
264
- Serve a notebook as an app with `marimo run` at the command-line.
265
- Of course, you can use marimo just to level-up your
266
- notebooking, without ever making apps.
267
- """
268
- )
269
- return
270
 
271
 
272
  @app.cell(hide_code=True)
273
- def __(mo):
274
- mo.md(
275
- """
276
- ## 5. The `marimo` command-line tool
277
-
278
- **Creating and editing notebooks.** Use
279
-
280
- ```
281
- marimo edit
282
- ```
283
-
284
- in a terminal to start the marimo notebook server. From here
285
- you can create a new notebook or edit existing ones.
286
-
287
-
288
- **Running as apps.** Use
289
-
290
- ```
291
- marimo run notebook.py
292
- ```
293
-
294
- to start a webserver that serves your notebook as an app in read-only mode,
295
- with code cells hidden.
296
-
297
- **Convert a Jupyter notebook.** Convert a Jupyter notebook to a marimo
298
- notebook using `marimo convert`:
299
-
300
- ```
301
- marimo convert your_notebook.ipynb > your_app.py
302
- ```
303
-
304
- **Tutorials.** marimo comes packaged with tutorials:
305
 
306
- - `dataflow`: more on marimo's automatic execution
307
- - `ui`: how to use UI elements
308
- - `markdown`: how to write markdown, with interpolated values and
309
- LaTeX
310
- - `plots`: how plotting works in marimo
311
- - `sql`: how to use SQL
312
- - `layout`: layout elements in marimo
313
- - `fileformat`: how marimo's file format works
314
- - `markdown-format`: for using `.md` files in marimo
315
- - `for-jupyter-users`: if you are coming from Jupyter
316
-
317
- Start a tutorial with `marimo tutorial`; for example,
318
-
319
- ```
320
- marimo tutorial dataflow
321
- ```
322
-
323
- In addition to tutorials, we have examples in our
324
- [our GitHub repo](https://www.github.com/marimo-team/marimo/tree/main/examples).
325
- """
326
- )
327
- return
328
 
329
 
330
  @app.cell(hide_code=True)
331
- def __(mo):
332
- mo.md(
333
- """
334
- ## 6. The marimo editor
335
-
336
- Here are some tips to help you get started with the marimo editor.
337
- """
338
  )
339
- return
340
-
341
 
342
- @app.cell
343
- def __(mo, tips):
344
- mo.accordion(tips)
345
  return
346
 
347
 
348
- @app.cell(hide_code=True)
349
- def __(mo):
350
- mo.md("""## Finally, a fun fact""")
351
- return
352
-
353
-
354
- @app.cell(hide_code=True)
355
- def __(mo):
356
- mo.md(
357
- """
358
- The name "marimo" is a reference to a type of algae that, under
359
- the right conditions, clumps together to form a small sphere
360
- called a "marimo moss ball". Made of just strands of algae, these
361
- beloved assemblages are greater than the sum of their parts.
362
- """
363
- )
364
- return
365
-
366
-
367
- @app.cell(hide_code=True)
368
- def __():
369
- tips = {
370
- "Saving": (
371
- """
372
- **Saving**
373
-
374
- - _Name_ your app using the box at the top of the screen, or
375
- with `Ctrl/Cmd+s`. You can also create a named app at the
376
- command line, e.g., `marimo edit app_name.py`.
377
-
378
- - _Save_ by clicking the save icon on the bottom right, or by
379
- inputting `Ctrl/Cmd+s`. By default marimo is configured
380
- to autosave.
381
- """
382
- ),
383
- "Running": (
384
- """
385
- 1. _Run a cell_ by clicking the play ( ▷ ) button on the top
386
- right of a cell, or by inputting `Ctrl/Cmd+Enter`.
387
-
388
- 2. _Run a stale cell_ by clicking the yellow run button on the
389
- right of the cell, or by inputting `Ctrl/Cmd+Enter`. A cell is
390
- stale when its code has been modified but not run.
391
-
392
- 3. _Run all stale cells_ by clicking the play ( ▷ ) button on
393
- the bottom right of the screen, or input `Ctrl/Cmd+Shift+r`.
394
- """
395
- ),
396
- "Console Output": (
397
- """
398
- Console output (e.g., `print()` statements) is shown below a
399
- cell.
400
- """
401
- ),
402
- "Creating, Moving, and Deleting Cells": (
403
- """
404
- 1. _Create_ a new cell above or below a given one by clicking
405
- the plus button to the left of the cell, which appears on
406
- mouse hover.
407
-
408
- 2. _Move_ a cell up or down by dragging on the handle to the
409
- right of the cell, which appears on mouse hover.
410
-
411
- 3. _Delete_ a cell by clicking the trash bin icon. Bring it
412
- back by clicking the undo button on the bottom right of the
413
- screen, or with `Ctrl/Cmd+Shift+z`.
414
- """
415
- ),
416
- "Disabling Automatic Execution": (
417
- """
418
- Via the notebook settings (gear icon) or footer panel, you
419
- can disable automatic execution. This is helpful when
420
- working with expensive notebooks or notebooks that have
421
- side-effects like database transactions.
422
- """
423
- ),
424
- "Disabling Cells": (
425
- """
426
- You can disable a cell via the cell context menu.
427
- marimo will never run a disabled cell or any cells that depend on it.
428
- This can help prevent accidental execution of expensive computations
429
- when editing a notebook.
430
- """
431
- ),
432
- "Code Folding": (
433
- """
434
- You can collapse or fold the code in a cell by clicking the arrow
435
- icons in the line number column to the left, or by using keyboard
436
- shortcuts.
437
-
438
- Use the command palette (`Ctrl/Cmd+k`) or a keyboard shortcut to
439
- quickly fold or unfold all cells.
440
- """
441
- ),
442
- "Code Formatting": (
443
- """
444
- If you have [ruff](https://github.com/astral-sh/ruff) installed,
445
- you can format a cell with the keyboard shortcut `Ctrl/Cmd+b`.
446
- """
447
- ),
448
- "Command Palette": (
449
- """
450
- Use `Ctrl/Cmd+k` to open the command palette.
451
- """
452
- ),
453
- "Keyboard Shortcuts": (
454
- """
455
- Open the notebook menu (top-right) or input `Ctrl/Cmd+Shift+h` to
456
- view a list of all keyboard shortcuts.
457
- """
458
- ),
459
- "Configuration": (
460
- """
461
- Configure the editor by clicking the gears icon near the top-right
462
- of the screen.
463
- """
464
- ),
465
- }
466
- return (tips,)
467
-
468
-
469
  if __name__ == "__main__":
470
  app.run()
 
1
  import marimo
2
 
3
+ __generated_with = "0.9.14"
4
+ app = marimo.App(width="medium")
5
 
6
 
7
+ @app.cell(hide_code=True)
8
  def __():
9
  import marimo as mo
10
+ import duckdb
11
+ import pandas
12
+ import numpy
13
+ import altair as alt
14
+ import plotly.express as px
15
 
16
+ mo.md("# 🤗 Hub Model Tree")
17
+ return alt, duckdb, mo, numpy, pandas, px
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
18
 
19
 
20
  @app.cell(hide_code=True)
21
  def __(mo):
22
+ mo.md("""This is powered by the [Hub Stats](https://huggingface.co/datasets/cfahlgren1/hub-stats) dataset which you can query via the [SQL Console](https://huggingface.co/datasets/cfahlgren1/hub-stats?sql_console=true). The model tree metric is where a model tags a parent model as a `base_model`. The `hub-stats` dataset gets updated daily. Try it out by putting an organization or model author in search box and hit enter.""")
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
23
  return
24
 
25
 
26
  @app.cell
27
+ def __(duckdb):
28
+ duckdb.sql("CREATE VIEW models as SELECT * FROM '~/Downloads/models.parquet'")
29
+ return (models,)
30
 
31
 
32
  @app.cell(hide_code=True)
33
  def __(mo):
34
+ author_input = mo.ui.text(placeholder="Search...", label="Author")
 
 
 
 
 
 
 
 
 
 
 
 
 
 
35
 
36
+ ctes = """
37
+ WITH author_models AS (
38
+ SELECT id
39
+ FROM models
40
+ WHERE author = '{}'
41
+ ),
42
+ model_tags AS (
43
+ SELECT
44
+ id,
45
+ UNNEST(tags) AS tag
46
+ FROM models
47
  )
48
+ """
49
+ def get_model_children_counts(author: str) -> str:
50
+ return f"""
51
+ {ctes.format(author)}
52
+ SELECT
53
+ am.id as parent_model_id,
54
+ COUNT(DISTINCT m.id) as num_direct_children
55
+ FROM author_models am
56
+ INNER JOIN model_tags m
57
+ ON m.tag = 'base_model:' || am.id
58
+ GROUP BY am.id
59
+ ORDER BY num_direct_children DESC;
60
+ """
61
+
62
+ def get_total_childen_count(author: str) -> str:
63
+ return f"""
64
+ {ctes.format(author)}
65
+ SELECT
66
+ COUNT(DISTINCT m.id) as num_direct_children
67
+ FROM author_models am
68
+ LEFT JOIN model_tags m
69
+ ON m.tag = 'base_model:' || am.id
70
+ """
71
+ return (
72
+ author_input,
73
+ ctes,
74
+ get_model_children_counts,
75
+ get_total_childen_count,
76
  )
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
77
 
78
 
79
  @app.cell
80
  def __(mo):
81
+ mo.md("## Search by Author")
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
82
  return
83
 
84
 
85
  @app.cell(hide_code=True)
86
+ def __(author_input, mo):
87
+ mo.vstack([author_input, mo.md("_ex: meta-llama, google, mistralai, Qwen_")])
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
88
  return
89
 
90
 
91
  @app.cell(hide_code=True)
92
+ def __(author_input, duckdb, get_total_childen_count, mo):
93
+ result = duckdb.sql(get_total_childen_count(author_input.value)).fetchall()
94
+ mo.vstack([mo.md("### Direct Child Models"), mo.md(f"_The number of models that have tagged a {author_input.value} model as a `base_model`_"), mo.stat(result[0][0])])
95
+ return (result,)
 
 
 
 
 
 
 
 
 
 
96
 
97
 
98
  @app.cell(hide_code=True)
99
+ def __(author_input, duckdb, get_model_children_counts):
100
+ df = duckdb.sql(get_model_children_counts(author_input.value)).fetchdf()
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
101
 
102
+ df
103
+ return (df,)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
104
 
105
 
106
  @app.cell(hide_code=True)
107
+ def __(df, mo, px):
108
+ _plot = px.bar(
109
+ df, x="parent_model_id", y="num_direct_children", log_y=True
 
 
 
 
110
  )
 
 
111
 
112
+ mo.ui.plotly(_plot)
 
 
113
  return
114
 
115
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
116
  if __name__ == "__main__":
117
  app.run()
requirements.txt CHANGED
@@ -1,5 +1,43 @@
1
- marimo
2
- # Or a specific version
3
- # marimo>=0.9.0
4
-
5
- # Add other dependencies as needed
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ altair==5.4.1
2
+ anyio==4.6.2.post1
3
+ attrs==24.2.0
4
+ click==8.1.7
5
+ docutils==0.21.2
6
+ duckdb==1.1.3
7
+ exceptiongroup==1.2.2
8
+ h11==0.14.0
9
+ idna==3.10
10
+ importlib_metadata==8.5.0
11
+ itsdangerous==2.2.0
12
+ jedi==0.19.1
13
+ Jinja2==3.1.4
14
+ jsonschema==4.23.0
15
+ jsonschema-specifications==2024.10.1
16
+ marimo==0.9.14
17
+ Markdown==3.7
18
+ MarkupSafe==3.0.2
19
+ narwhals==1.13.2
20
+ numpy==2.0.2
21
+ packaging==24.1
22
+ pandas==2.2.3
23
+ parso==0.8.4
24
+ plotly==5.24.1
25
+ psutil==6.1.0
26
+ Pygments==2.18.0
27
+ pymdown-extensions==10.12
28
+ python-dateutil==2.9.0.post0
29
+ pytz==2024.2
30
+ PyYAML==6.0.2
31
+ referencing==0.35.1
32
+ rpds-py==0.20.1
33
+ ruff==0.7.2
34
+ six==1.16.0
35
+ sniffio==1.3.1
36
+ starlette==0.41.2
37
+ tenacity==9.0.0
38
+ tomlkit==0.13.2
39
+ typing_extensions==4.12.2
40
+ tzdata==2024.2
41
+ uvicorn==0.32.0
42
+ websockets==12.0
43
+ zipp==3.20.2