Repository navigation
Expand file tree
/
Copy pathindex.html
More file actions
1288 lines (1187 loc) · 73.2 KB
/
Copy pathindex.html
File metadata and controls
1288 lines (1187 loc) · 73.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>MiniLake — The Databricks API, running on your laptop</title>
<meta name="description" content="MiniLake is a free, open-source local Databricks API emulator. Real SQL, real Delta Lake and real Spark job execution — for databricks-sdk, the CLI, Terraform, Asset Bundles and LLM agents. No account, no API key, no cloud bill." />
<link rel="canonical" href="https://dmux.github.io/minilake/" />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://dmux.github.io/minilake/" />
<meta property="og:title" content="MiniLake — The Databricks API, running on your laptop" />
<meta property="og:description" content="A local Databricks emulator with real SQL, real Delta Lake and real Spark jobs. Point databricks-sdk, Terraform or an LLM agent at localhost." />
<meta property="og:image" content="https://dmux.github.io/minilake/assets/og.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="MiniLake — The Databricks API, running on your laptop" />
<meta name="twitter:description" content="A local Databricks emulator with real SQL, real Delta Lake and real Spark jobs. No account, no API key, no cloud bill." />
<meta name="twitter:image" content="https://dmux.github.io/minilake/assets/og.png" />
<meta name="theme-color&quo
8000
t; content="#FFFFFF" media="(prefers-color-scheme: light)" />
<meta name="theme-color" content="#080F1A" media="(prefers-color-scheme: dark)" />
<link rel="icon" type="image/png" sizes="64x64" href="assets/favicon-64.png" />
<link rel="icon" type="image/png" sizes="32x32" href="assets/favicon-32.png" />
<link rel="apple-touch-icon" href="assets/apple-touch-icon.png" />
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
<style>
/* ---------- tokens ----------
Light is the base palette; dark redefines only what changes. Anything that
always sits on a navy panel (.band, .cta, .window) keeps a literal colour —
those surfaces are dark in both themes. */
:root{
color-scheme:light;
--brand-navy:#0C2340; /* the logo navy: never themed */
--navy:#0C2340; /* heading ink, flips light in dark mode */
--navy-2:#16345F;
--blue:#0A55D0;
--blue-2:#1C64DE;
--blue-soft:#EAF1FE;
--blue-line:#D5E3FC;
--btn-top:#1C64DE; /* the primary button is its own pair: --blue
goes light in dark mode for link legibility,
which white text cannot sit on */
--btn-bottom:#0A55D0;
--orange:#F5811F;
--orange-soft:#FFF1E3;
--orange-line:#FBDCBE;
--orange-ink:#B45A0B;
--ink:#0C2340;
--text-muted:#546279;
--text-faint:#6B7B94; /* small uppercase labels: 4.3:1 on white */
--line:#E3E9F2;
--line-soft:#EEF2F8;
--line-strong:#CBD7EA;
--bg:#FFFFFF;
--bg-alt:#F7F9FD;
--surface:#FFFFFF; /* cards, header, table, arch diagram */
--surface-2:#FBFCFF; /* hover tint, table head, honest cards */
--surface-3:#F2F5FA; /* inline code chips */
--hdr-bg:rgba(255,255,255,.82);
--panel-line:transparent; /* navy panels need an edge only in dark */
--tab-on:#0C2340;
--tab-on-ink:#FFFFFF;
--ok-ink:#1F6B45;
--ok-bg:#E9F7EF;
--ok-line:#CFEBDC;
--neutral-ink:#6B7688;
--neutral-bg:#F1F4F9;
--neutral-line:#E1E7F0;
--arch-line:#C4D1E4;
--arch-arrow:#9DB2CE;
--code:#0A1B33;
--radius:14px;
--radius-lg:20px;
--shadow-sm:0 1px 2px rgba(12,35,64,.05), 0 1px 3px rgba(12,35,64,.04);
--shadow:0 12px 30px -12px rgba(12,35,64,.16), 0 2px 8px rgba(12,35,64,.05);
--shadow-lg:0 40px 80px -32px rgba(12,35,64,.32);
--logo-glow:none;
--maxw:1160px;
}
/* The inline head script stamps data-theme before first paint, so this block
only has to cover the no-JS case; [data-theme="light"] must still win. */
@media (prefers-color-scheme:dark){
:root:not([data-theme="light"]){
color-scheme:dark;
--navy:#DCE7F8;
--navy-2:#B9CDE9;
--blue:#7CACFF;
--blue-2:#9DC2FF;
--blue-soft:#132845;
--blue-line:#1F3B65;
--btn-top:#2F6FE4;
--btn-bottom:#1B54C4;
--orange:#F79A47;
--orange-soft:#3A2411;
--orange-line:#5B3A18;
--orange-ink:#F0A868;
--ink:#E6EDF8;
--text-muted:#9BAAC4;
--text-faint:#8394AE;
--line:#1F2E45;
--line-soft:#17243A;
--line-strong:#2C3D59;
--bg:#080F1A;
--bg-alt:#0C1626;
--surface:#0F1B2C;
--surface-2:#132133;
--surface-3:#16243A;
--hdr-bg:rgba(8,15,26,.82);
--panel-line:#1F2E45;
--tab-on:#1E4FA8;
--tab-on-ink:#EAF2FF;
--ok-ink:#7BE1A6;
--ok-bg:#102A1E;
--ok-line:#1F4A35;
--neutral-ink:#9AA8BE;
--neutral-bg:#161F2E;
--neutral-line:#26334A;
--arch-line:#2C3E5A;
--arch-arrow:#4A6086;
--code:#060E1A;
--shadow-sm:0 1px 2px rgba(0,0,0,.4);
--shadow:0 12px 30px -12px rgba(0,0,0,.6), 0 2px 8px rgba(0,0,0,.4);
--shadow-lg:0 40px 80px -32px rgba(0,0,0,.75);
--logo-glow:drop-shadow(0 0 30px rgba(124,172,255,.22));
}
}
:root[data-theme="dark"]{
color-scheme:dark;
--navy:#DCE7F8;
--navy-2:#B9CDE9;
--blue:#7CACFF;
--blue-2:#9DC2FF;
--blue-soft:#132845;
--blue-line:#1F3B65;
--btn-top:#2F6FE4;
--btn-bottom:#1B54C4;
--orange:#F79A47;
--orange-soft:#3A2411;
--orange-line:#5B3A18;
--orange-ink:#F0A868;
--ink:#E6EDF8;
--text-muted:#9BAAC4;
--text-faint:#8394AE;
--line:#1F2E45;
--line-soft:#17243A;
--line-strong:#2C3D59;
--bg:#080F1A;
--bg-alt:#0C1626;
--surface:#0F1B2C;
--surface-2:#132133;
--surface-3:#16243A;
--hdr-bg:rgba(8,15,26,.82);
--panel-line:#1F2E45;
--tab-on:#1E4FA8;
--tab-on-ink:#EAF2FF;
--ok-ink:#7BE1A6;
--ok-bg:#102A1E;
--ok-line:#1F4A35;
--neutral-ink:#9AA8BE;
--neutral-bg:#161F2E;
--neutral-line:#26334A;
--arch-line:#2C3E5A;
--arch-arrow:#4A6086;
--code:#060E1A;
--shadow-sm:0 1px 2px rgba(0,0,0,.4);
--shadow:0 12px 30px -12px rgba(0,0,0,.6), 0 2px 8px rgba(0,0,0,.4);
--shadow-lg:0 40px 80px -32px rgba(0,0,0,.75);
--logo-glow:drop-shadow(0 0 30px rgba(124,172,255,.22));
}
*,*::before,*::after{box-sizing:border-box}
html{-webkit-text-size-adjust:100%;scroll-behavior:smooth;scroll-padding-top:88px}
@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto}}
body{
margin:0;background:var(--bg);color:var(--ink);
font-family:"Inter",-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
font-size:17px;line-height:1.65;letter-spacing:-.01em;
-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility;
}
img{max-width:100%;height:auto;display:block}
a{color:var(--blue);text-decoration:none}
a:hover{color:var(--blue-2)}
h1,h2,h3,h4{margin:0;line-height:1.15;letter-spacing:-.03em;font-weight:700}
p{margin:0}
code,kbd,pre{font-family:"JetBrains Mono",ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
::selection{background:#0A55D022}
.wrap{width:100%;max-width:var(--maxw);margin-inline:auto;padding-inline:24px}
.section{padding:96px 0}
.section--tight{padding:72px 0}
.alt{background:var(--bg-alt);border-block:1px solid var(--line-soft)}
/* ---------- header ---------- */
.hdr{position:sticky;top:0;z-index:60;background:var(--hdr-bg);backdrop-filter:saturate(180%) blur(14px);-webkit-backdrop-filter:saturate(180%) blur(14px);border-bottom:1px solid transparent;transition:border-color .2s ease, box-shadow .2s ease}
.hdr.is-stuck{border-bottom-color:var(--line);box-shadow:0 1px 0 rgba(12,35,64,.02)}
.nav{display:flex;align-items:center;gap:28px;height:68px}
.brand{display:flex;flex:none;align-items:center;gap:11px;font-weight:800;font-size:19px;color:var(--ink);letter-spacing:-.035em}
.brand:hover{color:var(--ink)}
.brand img{width:32px;height:32px}
.brand .v{font:500 11px/1 "JetBrains Mono",monospace;letter-spacing:0;color:var(--blue);background:var(--blue-soft);border:1px solid var(--blue-line);padding:4px 7px;border-radius:999px;margin-left:2px}
.nav-links{display:flex;gap:26px;margin-left:auto;align-items:center}
.nav-links a{color:var(--text-muted);font-size:15px;font-weight:500}
.nav-links a:hover{color:var(--ink)}
.nav-cta{display:flex;align-items:center;gap:10px}
.theme-toggle{display:inline-flex;align-items:center;justify-content:center;width:38px;height:38px;flex:none;background:var(--surface);border:1px solid var(--line);border-radius:11px;color:var(--text-muted);cursor:pointer;transition:color .15s ease,border-color .15s ease,background .2s ease}
.theme-toggle:hover{color:var(--ink);border-color:var(--line-strong)}
.theme-toggle svg{width:18px;height:18px}
.theme-toggle .i-moon{display:none}
[data-theme="dark"] .theme-toggle .i-moon{display:block}
[data-theme="dark"] .theme-toggle .i-sun{display:none}
.burger{display:none;margin-left:auto;background:none;border:1px solid var(--line);border-radius:10px;padding:8px;cursor:pointer;color:var(--ink)}
/* ---------- buttons ---------- */
.btn{display:inline-flex;align-items:center;gap:9px;font-weight:600;font-size:15px;padding:11px 18px;border-radius:11px;border:1px solid transparent;cursor:pointer;transition:transform .12s ease, box-shadow .2s ease, background .2s ease, border-color .2s ease;white-space:nowrap}
.btn svg{width:17px;height:17px;flex:none}
.btn-primary{background:linear-gradient(180deg,var(--btn-top),var(--btn-bottom));color:#fff;box-shadow:0 1px 0 rgba(255,255,255,.25) inset, 0 8px 20px -8px rgba(10,85,208,.6)}
.btn-primary:hover{color:#fff;transform:translateY(-1px);box-shadow:0 1px 0 rgba(255,255,255,.3) inset, 0 12px 26px -10px rgba(10,85,208,.7)}
.btn-ghost{background:var(--surface);border-color:var(--line);color:var(--ink)}
.btn-ghost:hover{border-color:var(--line-strong);color:var(--ink);transform:translateY(-1px)}
.btn-lg{font-size:16px;padding:14px 22px;border-radius:12px}
.btn-dark{background:#fff;color:var(--brand-navy)}
.btn-dark:hover{color:var(--brand-navy);transform:translateY(-1px)}
.btn-outline-light{border-color:rgba(255,255,255,.28);color:#fff;background:rgba(255,255,255,.06)}
.btn-outline-light:hover{color:#fff;background:rgba(255,255,255,.12)}
/* ---------- hero ---------- */
.hero{position:relative;overflow:hidden;padding:84px 0 72px}
.hero::before{content:"";position:absolute;inset:-30% -10% auto -10%;height:820px;background:
radial-gradient(48% 46% at 22% 18%, rgba(10,85,208,.13) 0%, rgba(10,85,208,0) 70%),
radial-gradient(42% 40% at 82% 6%, rgba(245,129,31,.13) 0%, rgba(245,129,31,0) 70%);
pointer-events:none}
.hero::after{content:"";position:absolute;inset:0;background-image:linear-gradient(var(--line-soft) 1px,transparent 1px),linear-gradient(90deg,var(--line-soft) 1px,transparent 1px);background-size:56px 56px;-webkit-mask-image:radial-gradient(70% 55% at 50% 22%,#000,transparent 75%);mask-image:radial-gradient(70% 55% at 50% 22%,#000,transparent 75%);opacity:.85;pointer-events:none}
.hero .wrap{position:relative;z-index:1}
.hero-grid{display:grid;grid-template-columns:minmax(0,1.22fr) minmax(0,.78fr);gap:48px;align-items:center}
.eyebrow{display:inline-flex;align-items:center;gap:9px;font-size:13px;font-weight:600;color:var(--navy-2);background:var(--surface);border:1px solid var(--line);border-radius:999px;padding:6px 14px 6px 8px;box-shadow:var(--shadow-sm)}
.eyebrow .dot{width:7px;height:7px;border-radius:50%;background:var(--orange);box-shadow:0 0 0 4px var(--orange-soft)}
h1{font-size:clamp(32px,5.2vw,56px);font-weight:800;margin:22px 0 0;letter-spacing:-.04em}
h1 .grad{background:linear-gradient(96deg,var(--blue) 10%,var(--orange) 92%);-webkit-background-clip:text;background-clip:text;color:transparent}
.lede{margin-top:20px;font-size:19px;color:var(--text-muted);max-width:36em}
.lede strong{color:var(--ink);font-weight:600}
.hero-actions{display:flex;flex-wrap:wrap;gap:12px;margin-top:30px}
.hero-note{margin-top:18px;font-size:14px;color:var(--text-muted)}
.hero-art{display:flex;justify-content:center}
.hero-art img{width:min(360px,80%);filter:drop-shadow(0 30px 50px rgba(12,35,64,.18)) var(--logo-glow)}
@media (prefers-reduced-motion:no-preference){.hero-art img{animation:float 7s ease-in-out infinite}}
@keyframes float{0%,100%{transform:translateY(0)}50%{transform:translateY(-12px)}}
/* ---------- install strip ---------- */
.install{margin-top:34px;display:grid;grid-template-columns:minmax(0,1fr);gap:10px;max-width:640px}
.cmd{display:flex;align-items:center;gap:12px;background:var(--code);border-radius:12px;padding:13px 13px 13px 16px;box-shadow:var(--shadow)}
.cmd code{color:#DCE6F7;font-size:14px;overflow-x:auto;white-space:nowrap;flex:1;min-width:0}
.cmd .p{color:#5F7CA8;user-select:none}
.cmd .tag{font:500 11px/1 "JetBrains Mono",monospace;color:#7E9DCB;border:1px solid #233A5E;border-radius:6px;padding:5px 7px;white-space:nowrap}
.copy{background:rgba(255,255,255,.07);border:1px solid rgba(255,255,255,.14);color:#C9D8EE;border-radius:8px;padding:6px 9px;cursor:pointer;display:inline-flex;align-items:center;gap:6px;font:600 12px/1 "Inter",sans-serif;transition:background .15s ease,color .15s ease}
.copy:hover{background:rgba(255,255,255,.14);color:#fff}
.copy svg{width:13px;height:13px}
.copy.done{color:#7BE1A6;border-color:#2C5C42}
/* ---------- trust strip ---------- */
.trust{border-block:1px solid var(--line-soft);background:linear-gradient(180deg,var(--surface),var(--surface-2))}
.trust-inner{display:flex;align-items:center;gap:14px 30px;flex-wrap:wrap;padding:22px 0}
.trust-label{font-size:12px;letter-spacing:.1em;text-transform:uppercase;font-weight:700;color:var(--text-faint)}
.trust-items{display:flex;flex-wrap:wrap;gap:10px 22px}
.trust-items span{font-size:14.5px;font-weight:600;color:var(--navy-2);display:inline-flex;align-items:center;gap:8px}
.trust-items span::before{content:"";width:5px;height:5px;border-radius:50%;background:var(--line-strong)}
/* ---------- stats ---------- */
.stats{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:0;border:1px solid var(--line);border-radius:var(--radius-lg);overflow:hidden;background:var(--surface);box-shadow:var(--shadow-sm)}
.stat{padding:28px 26px;border-right:1px solid var(--line-soft)}
.stat:last-child{border-right:0}
.stat b{display:block;font-size:34px;font-weight:800;letter-spacing:-.04em;color:var(--navy);line-height:1.1}
.stat b em{font-style:normal;color:var(--orange)}
.stat span{display:block;margin-top:6px;font-size:14.5px;color:var(--text-muted);line-height:1.45}
/* ---------- section heads ---------- */
.head{max-width:760px;margin-bottom:52px}
.head.center{margin-inline:auto;text-align:center}
.kicker{font-size:12.5px;font-weight:700;letter-spacing:.13em;text-transform:uppercase;color:var(--blue)}
.head h2{font-size:clamp(26px,3.6vw,42px);margin-top:14px;font-weight:800}
.head p{margin-top:16px;font-size:18px;color:var(--text-muted)}
/* ---------- feature grid ---------- */
.grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:18px}
.card{position:relative;background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);padding:26px;transition:transform .18s ease,box-shadow .22s ease,border-color .18s ease}
.card:hover{transform:translateY(-3px);box-shadow:var(--shadow);border-color:var(--line-strong)}
.card .ico{width:40px;height:40px;border-radius:11px;display:grid;place-items:center;background:var(--blue-soft);color:var(--blue);margin-bottom:16px}
.card .ico svg{width:20px;height:20px}
.card.accent .ico{background:var(--orange-soft);color:var(--orange-ink)}
.card h3{font-size:17.5px;font-weight:700;letter-spacing:-.02em}
.card p{margin-top:9px;font-size:15px;color:var(--text-muted);line-height:1.6}
.card p code{font-size:13px;background:var(--surface-3);border:1px solid var(--line-soft);border-radius:5px;padding:1px 5px;color:var(--navy-2)}
.tagline{display:inline-block;margin-top:14px;font:600 12px/1 "Inter",sans-serif;color:var(--ok-ink);background:var(--ok-bg);border:1px solid var(--ok-line);border-radius:999px;padding:5px 10px}
.tagline.blue{color:var(--blue);background:var(--blue-soft);border-color:var(--blue-line)}
.tagline.orange{color:var(--orange-ink);background:var(--orange-soft);border-color:var(--orange-line)}
/* ---------- code tabs ---------- */
.tabs{display:flex;gap:6px;flex-wrap:wrap;margin-bottom:16px}
.tab{background:var(--surface);border:1px solid var(--line);color:var(--text-muted);font:600 14px/1 "Inter",sans-serif;padding:10px 15px;border-radius:10px;cursor:pointer;transition:.15s ease}
.tab:hover{color:var(--ink);border-color:var(--line-strong)}
.tab[aria-selected="true"]{background:var(--tab-on);border-color:var(--tab-on);color:var(--tab-on-ink)}
.window{background:var(--code);border-radius:var(--radius-lg);box-shadow:var(--shadow-lg);overflow:hidden;border:1px solid #16294A}
.window-bar{display:flex;align-items:center;gap:8px;padding:12px 16px;border-bottom:1px solid #16294A;background:linear-gradient(180deg,#0E2140,#0A1B33)}
.dots{display:flex;gap:6px}
.dots i{width:10px;height:10px;border-radius:50%;display:block}
.dots i:nth-child(1){background:#FF5F57}.dots i:nth-child(2){background:#FEBC2E}.dots i:nth-child(3){background:#28C840}
.window-title{margin-left:6px;font:500 12.5px/1 "JetBrains Mono",monospace;color:#7E9DCB}
.window .copy{margin-left:auto}
pre{margin:0;padding:24px 26px;overflow-x:auto;font-size:13.6px;line-height:1.75;color:#D7E3F5}
pre code{color:inherit}
.tok-c{color:#6E86A8;font-style:italic}
.tok-s{color:#FFB980}
.tok-k{color:#79B0FF}
.tok-f{color:#8FE1C0}
.tok-n{color:#C6A9FF}
.split{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1.25fr);gap:44px;align-items:center}
.checks{display:grid;grid-template-columns:minmax(0,1fr);gap:14px;margin-top:26px;padding:0;list-style:none}
.checks code,.card p code,.desc code,.note code,.lede code,.hero-note code{overflow-wrap:anywhere}
.checks li{display:flex;gap:12px;font-size:15.5px;color:var(--text-muted);line-height:1.55}
.checks li b{color:var(--ink);font-weight:600}
.checks svg{width:20px;height:20px;flex:none;color:var(--ok-ink);margin-top:1px}
/* ---------- architecture ---------- */
.arch{border:1px solid var(--line);background:var(--surface);border-radius:var(--radius-lg);padding:34px 28px;box-shadow:var(--shadow-sm);overflow-x:auto}
/* diagram styles live here, not in the SVG: an inline <svg><style> is
document-global, and these need to follow the theme */
.arch svg .lbl{font:600 13px "Inter",sans-serif;fill:var(--ink)}
.arch svg .sub{font:400 11.5px "Inter",sans-serif;fill:var(--text-muted)}
.arch svg .wht{font:700 15px "Inter",sans-serif;fill:#fff}
.arch svg .wsub{font:400 12px "JetBrains Mono",monospace;fill:#9FBBE4}
.arch svg .chip{font:600 12px "JetBrains Mono",monospace;fill:#DCE7F8}
.arch svg .cap{font:700 10.5px "Inter",sans-serif;fill:var(--text-faint);letter-spacing:.12em}
.arch svg .box{fill:var(--surface);stroke:var(--line)}
.arch svg .line{stroke:var(--arch-line);stroke-width:1.6;fill:none}
.arch svg #arw path{fill:var(--arch-arrow)}
.arch svg{min-width:720px;width:100%;height:auto;display:block;margin-inline:auto;max-width:960px}
/* ---------- mcp band ---------- */
.band{background:linear-gradient(160deg,#0C2340 0%,#12305A 55%,#0A2B63 100%);color:#fff;border:1px solid var(--panel-line);border-radius:26px;padding:56px;position:relative;overflow:hidden;box-shadow:var(--shadow-lg)}
.band::after{content:"";position:absolute;inset:auto -80px -140px auto;width:420px;height:420px;border-radius:50%;background:radial-gradient(circle,rgba(245,129,31,.28),transparent 62%)}
.band > *{position:relative;z-index:1}
.band .kicker{color:#FFB36B}
.band h2{font-size:clamp(25px,3.4vw,40px);font-weight:800;margin-top:14px}
.band p{color:#B8CBE8;margin-top:16px;font-size:17.5px;max-width:52ch}
.band-grid{display:grid;grid-template-columns:minmax(0,.95fr) minmax(0,1.05fr);gap:44px;align-items:center}
.tool-list{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px;margin-top:28px;padding:0;list-style:none}
.tool-list li{background:rgba(255,255,255,.06);border:1px solid rgba(255,255,255,.12);border-radius:10px;padding:11px 13px;font:500 13px/1.4 "JetBrains Mono",monospace;color:#DCE7F8}
.tool-list li em{display:block;font:400 12px/1.45 "Inter",sans-serif;font-style:normal;color:#93AACD;margin-top:5px}
.band .window{box-shadow:0 30px 70px -30px rgba(0,0,0,.7)}
/* ---------- table ---------- */
.table-wrap{overflow-x:auto;border:1px solid var(--line);border-radius:var(--radius-lg);background:var(--surface);box-shadow:var(--shadow-sm)}
table{border-collapse:collapse;width:100%;min-width:680px;font-size:15px}
th,td{text-align:left;padding:15px 22px;border-bottom:1px solid var(--line-soft);vertical-align:top}
thead th{font-size:12px;letter-spacing:.09em;text-transform:uppercase;color:var(--text-faint);background:var(--surface-2);font-weight:700}
tbody tr:last-child td{border-bottom:0}
tbody tr:hover{background:var(--surface-2)}
td:first-child{font-weight:600;color:var(--ink);white-space:nowrap}
td.desc{color:var(--text-muted)}
.pill{display:inline-flex;align-items:center;gap:6px;font:600 12.5px/1 "Inter",sans-serif;padding:6px 10px;border-radius:999px;white-space:nowrap}
.pill.real{color:var(--ok-ink);background:var(--ok-bg);border:1px solid var(--ok-line)}
.pill.partial{color:var(--orange-ink);background:var(--orange-soft);border:1px solid var(--orange-line)}
.pill.no{color:var(--neutral-ink);background:var(--neutral-bg);border:1px solid var(--neutral-line)}
/* ---------- honest ---------- */
.honest{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:18px}
.honest .card{background:var(--surface-2)}
.honest .card h3{font-size:16.5px}
.note{margin-top:26px;font-size:15px;color:var(--text-muted);border-left:3px solid var(--orange);padding-left:16px;max-width:70ch}
/* ---------- cta ---------- */
.cta{background:linear-gradient(150deg,#0C2340,#153A73);color:#fff;border:1px solid var(--panel-line);border-radius:26px;padding:64px 56px;text-align:center;position:relative;overflow:hidden;box-shadow:var(--shadow-lg)}
.cta::before{content:"";position:absolute;inset:-60% 30% auto 30%;height:420px;background:radial-gradient(circle,rgba(10,85,208,.5),transparent 65%)}
.cta > *{position:relative;z-index:1}
.cta img{width:76px;height:76px;margin:0 auto 24px;background:#fff;border-radius:20px;padding:11px;box-shadow:0 14px 34px -12px rgba(0,0,0,.55)}
.cta h2{font-size:clamp(26px,3.6vw,42px);font-weight:800}
.cta p{color:#B8CBE8;margin-top:16px;font-size:18px;max-width:56ch;margin-inline:auto}
.cta .hero-actions{justify-content:center;margin-top:30px}
/* ---------- footer ---------- */
.ftr{border-top:1px solid var(--line);padding:56px 0 44px;background:var(--bg-alt)}
.ftr-grid{display:grid;grid-template-columns:1.4fr repeat(3,1fr);gap:36px}
.ftr h4{font-size:12px;letter-spacing:.1em;text-transform:uppercase;color:var(--text-faint);margin-bottom:14px}
.ftr ul{list-style:none;padding:0;margin:0;display:grid;grid-template-columns:minmax(0,1fr);gap:9px}
.ftr a{font-size:15px;color:var(--text-muted)}
.ftr a:hover{color:var(--blue)}
.ftr .about{font-size:14.5px;color:var(--text-muted);margin-top:14px;max-width:34ch}
.ftr-bottom{margin-top:44px;padding-top:22px;border-top:1px solid var(--line);display:flex;justify-content:space-between;gap:16px;flex-wrap:wrap;font-size:14px;color:var(--text-faint)}
/* ---------- reveal (only when JS can undo it) ---------- */
.js .rv{opacity:0;transform:translateY(14px)}
.js .rv.in{opacity:1;transform:none;transition:opacity .6s cubic-bezier(.2,.7,.3,1), transform .6s cubic-bezier(.2,.7,.3,1)}
@media (prefers-reduced-motion:reduce){.js .rv{opacity:1;transform:none}}
/* ---------- responsive ---------- */
/* `1fr` is `minmax(auto,1fr)`: a grid item then refuses to shrink below the
min-content of a nowrap command line or a <pre>, and the page scrolls
sideways. Every single-column fallback below uses minmax(0,1fr). */
/* the full nav needs ~920px (brand 191 + links 425 + buttons 197 + gutters);
it collapses on that measurement, well before the phone breakpoint */
@media (max-width:960px){
.nav{gap:14px}
.nav-links{display:none;position:absolute;top:68px;left:0;right:0;background:var(--bg);border-bottom:1px solid var(--line);flex-direction:column;align-items:stretch;gap:0;padding:8px 24px 18px}
.nav-links.open{display:flex}
.nav-links a{padding:12px 0;border-bottom:1px solid var(--line-soft)}
.nav-cta .btn-ghost{display:none}
.nav-cta .btn{padding:10px 14px;font-size:14px}
.burger{display:inline-flex}
}
@media (max-width:1024px){
.hero-grid{grid-template-columns:minmax(0,1fr);gap:36px}
.hero-art{order:-1}
.hero-art img{width:190px}
.grid,.honest{grid-template-columns:repeat(2,minmax(0,1fr))}
.split,.band-grid{grid-template-columns:minmax(0,1fr);gap:32px}
.stats{grid-template-columns:repeat(2,minmax(0,1fr))}
.stat:nth-child(2){border-right:0}
.stat:nth-child(1),.stat:nth-child(2){border-bottom:1px solid var(--line-soft)}
.band,.cta{padding:40px 28px}
.ftr-grid{grid-template-columns:repeat(2,minmax(0,1fr));gap:28px}
}
@media (max-width:720px){
body{font-size:16px}
.section{padding:68px 0}
.section--tight{padding:56px 0}
.wrap{padding-inline:20px}
.nav-links{padding-inline:20px}
.grid,.honest,.stats,.tool-list{grid-template-columns:minmax(0,1fr)}
.stat{border-right:0;border-bottom:1px solid var(--line-soft);padding:22px 20px}
.stat:last-child{border-bottom:0}
.hero{padding:56px 0}
.hero-art img{width:150px}
.head{margin-bottom:36px}
.lede{font-size:17.5px}
.install{margin-top:26px}
.cmd{padding:11px 11px 11px 13px;gap:8px}
.cmd .tag{display:none}
.hero-actions .btn{flex:1 1 auto;justify-content:center}
pre{font-size:12.6px;padding:18px}
.band,.cta{padding:32px 22px;border-radius:20px}
.cta{padding-block:44px}
.arch{padding:22px 16px}
/* the coverage table becomes stacked cards rather than a 680px side-scroller */
.table-wrap{overflow-x:visible}
table{min-width:0;display:block;font-size:15px}
thead{display:none}
tbody,tr,td{display:block}
tr{padding:18px 20px;border-bottom:1px solid var(--line-soft)}
tbody tr:last-child{border-bottom:0}
th,td{padding:0;border-bottom:0}
td:first-child{white-space:normal;font-size:16px}
td:nth-child(2){margin:9px 0 10px}
td.desc{font-size:14.5px;line-height:1.55}
.ftr{padding:44px 0 36px}
.ftr-grid{grid-template-columns:repeat(2,minmax(0,1fr));gap:28px 20px}
.ftr-grid > div:first-child{grid-column:1 / -1}
}
@media (max-width:460px){
/* the nav carries brand + theme + GitHub + burger: below this it only fits
once the version pill and the button label step aside */
.nav{gap:10px}
.brand{font-size:17px}
.brand .v{display:none}
.nav-cta .btn{padding:9px 11px}
.nav-cta .btn-primary .btn-label{display:none}
.nav-cta .btn svg{margin-inline:1px}
.theme-toggle{width:34px;height:34px}
.burger{padding:7px}
}
</style>
<script>
/* Runs before first paint: stamps the resolved theme so nothing flashes, and
marks JS as available for the reveal-on-scroll styles. */
(function () {
var root = document.documentElement;
root.className += " js";
var saved = null;
try { saved = localStorage.getItem("minilake-theme"); } catch (e) {}
var dark = saved ? saved === "dark"
: window.matchMedia("(prefers-color-scheme: dark)").matches;
root.setAttribute("data-theme", dark ? "dark" : "light");
})();
</script>
</head>
<body>
<header class="hdr" id="hdr">
<div class="wrap nav">
<a class="brand" href="#top"><img src="assets/minilake-logo.png" alt="" width="32" height="32" />MiniLake <span class="v">v1.8.0</span></a>
<nav class="nav-links" id="navlinks">
<a href="#features">Features</a>
<a href="#code">Examples</a>
<a href="#architecture">How it works</a>
<a href="#agents">For agents</a>
<a href="#coverage">Coverage</a>
</nav>
<div class="nav-cta">
<button class="theme-toggle" id="theme" type="button" aria-label="Switch theme" title="Switch theme">
<svg class="
10BC8
;i-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" aria-hidden="true"><circle cx="12" cy="12" r="4.2"/><path d="M12 2.4v2.2M12 19.4v2.2M4.2 12H2M22 12h-2.2M5.6 5.6 4 4M20 20l-1.6-1.6M18.4 5.6 20 4M4 20l1.6-1.6"/></svg>
<svg class="i-moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20.5 14.6A8.6 8.6 0 0 1 9.4 3.5a8.6 8.6 0 1 0 11.1 11.1Z"/></svg>
</button>
<a class="btn btn-ghost" href="https://github.com/dmux/minilake/blob/main/docs/index.md">Docs</a>
<a class="btn btn-primary" href="https://github.com/dmux/minilake">
<svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 .5C5.7.5.6 5.6.6 11.9c0 5 3.3 9.3 7.8 10.8.6.1.8-.2.8-.6v-2c-3.2.7-3.9-1.5-3.9-1.5-.5-1.3-1.3-1.7-1.3-1.7-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.7 1.3 3.4 1 .1-.8.4-1.3.7-1.6-2.6-.3-5.3-1.3-5.3-5.8 0-1.3.5-2.3 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.2 1.2a11 11 0 0 1 5.8 0c2.2-1.5 3.2-1.2 3.2-1.2.6 1.7.2 2.9.1 3.2.8.9 1.2 1.9 1.2 3.2 0 4.5-2.7 5.5-5.3 5.8.4.4.8 1.1.8 2.2v3.3c0 .4.2.7.8.6a11.4 11.4 0 0 0 7.8-10.8C23.4 5.6 18.3.5 12 .5Z"/></svg>
<span class="btn-label">GitHub</span>
</a>
</div>
<button class="burger" id="burger" aria-label="Menu" aria-expanded="false">
<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M4 7h16M4 12h16M4 17h16"/></svg>
</button>
</div>
</header>
<main id="top">
<!-- ============ HERO ============ -->
<section class="hero">
<div class="wrap">
<div class="hero-grid">
<div>
<span class="eyebrow"><span class="dot"></span> Open source · MIT · Python 3.11+ · Docker</span>
<h1>The Databricks API,<br /><span class="grad">running on your laptop.</span></h1>
<p class="lede">
MiniLake is a local <strong>Databricks API emulator</strong> with <strong>real SQL</strong>,
<strong>real Delta Lake</strong> and <strong>real Spark job execution</strong>. Point
<code>databricks-sdk</code>, the Databricks CLI, Terraform, Asset Bundles or an LLM agent at
<code>http://localhost:8000</code> — no account, no API key, no cloud bill.
</p>
<div class="install">
<div class="cmd">
<span class="p">$</span>
<code id="cmd-pip">pip install minilake && minilake --port 8000</code>
<span class="tag">PyPI</span>
<button class="copy" data-copy="#cmd-pip" aria-label="Copy install command">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="12" height="12" rx="2"/><path d="M5 15V5a2 2 0 0 1 2-2h10"/></svg>
Copy
</button>
</div>
<div class="cmd">
<span class="p">$</span>
<code id="cmd-docker">docker run -p 8000:8000 ghcr.io/dmux/minilake:latest</code>
<span class="tag">GHCR</span>
<button class="copy" data-copy="#cmd-docker" aria-label="Copy docker command">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="12" height="12" rx="2"/><path d="M5 15V5a2 2 0 0 1 2-2h10"/></svg>
Copy
</button>
</div>
</div>
<div class="hero-actions">
<a class="btn btn-primary btn-lg" href="https://github.com/dmux/minilake/blob/main/docs/getting-started.md">
Get started
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M13 6l6 6-6 6"/></svg>
</a>
<a class="btn btn-ghost btn-lg" href="#code">See it in code</a>
</div>
<p class="hero-note">Then open <code>http://localhost:8000/ui/</code> for the built-in SQL workspace. The image downloads nothing at runtime — it works air-gapped.</p>
</div>
<div class="hero-art">
<img src="assets/minilake-logo.png" alt="MiniLake logo" width="360" height="360" fetchpriority="high" />
</div>
</div>
</div>
</section>
<!-- ============ TRUST ============ -->
<div class="trust">
<div class="wrap trust-inner">
<span class="trust-label">Drop-in for</span>
<div class="trust-items">
<span>databricks-sdk (Python)</span>
<span>Databricks CLI</span>
<span>Terraform provider</span>
<span>Asset Bundles</span>
<span>PySpark + Delta</span>
<span>MCP agents</span>
</div>
</div>
</div>
<!-- ============ STATS ============ -->
<section class="section section--tight">
<div class="wrap">
<div class="stats rv">
<div class="stat"><b>30<em>+</em></b><span>Databricks API groups emulated, from Unity Catalog to SCIM</span></div>
<div class="stat"><b>67</b><span>MCP tools for LLM agents, served on the same port</span></div>
<div class="stat"><b>378<em>+</em></b><span>tests driven by the real Databricks SDK, not mocks</span></div>
<div class="stat"><b>$<em>0</em></b><span>cloud spend — everything runs on your machine</span></div>
</div>
</div>
</section>
<!-- ============ FEATURES ============ -->
<section class="section alt" id="features">
<div class="wrap">
<div class="head center rv">
<span class="kicker">What you get</span>
<h2>Not a mock server. A real engine behind a Databricks-shaped API.</h2>
<p>Fake endpoints let broken code pass. MiniLake executes your SQL on DuckDB, writes real Delta files, and runs real <code>spark-submit</code> jobs in containers — so a green test locally means something.</p>
</div>
<div class="grid">
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><ellipse cx="12" cy="5.5" rx="8" ry="3"/><path d="M4 5.5v13c0 1.7 3.6 3 8 3s8-1.3 8-3v-13"/><path d="M4 12c0 1.7 3.6 3 8 3s8-1.3 8-3"/></svg></div>
<h3>Unity Catalog, for real</h3>
<p>Catalogs, schemas, tables and volumes with full CRUD. Every catalog is its own DuckDB database file, so <code>catalog.schema.table</code> addressing is native — not a regex rewrite.</p>
<span class="tagline">Real execution</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M4 17V7l4 6 4-6 4 6 4-6v10"/></svg></div>
<h3>SQL that actually runs</h3>
<p>Statement execution on real DuckDB: <code>INLINE</code> and <code>EXTERNAL_LINKS</code> dispositions, <code>JSON_ARRAY</code> / <code>ARROW_STREAM</code> / <code>CSV</code> formats, and a result manifest that carries true column types.</p>
<span class="tagline">Real execution</span>
</article>
<article class="card rv accent">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2 4 7v10l8 5 8-5V7l-8-5Z"/><path d="M12 22V12M4 7l8 5 8-5"/></svg></div>
<h3>Real Delta Lake files</h3>
<p>EXTERNAL Delta tables are genuine Parquet plus a <code>_delta_log/</code>. <code>INSERT</code>, <code>UPDATE</code> and <code>DELETE</code> are routed through a real Spark job; reads go through DuckDB's <code>delta_scan()</code>.</p>
<span class="tagline orange">Real Delta</span>
</article>
<article class="card rv accent">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2 4.5 13.5H11L9.5 22 19 10h-6.5L13 2Z"/></svg></div>
<h3>Jobs that really execute</h3>
<p><code>spark_python_task</code> runs <code>spark-submit</code> in a sibling container and returns actual stdout. Real DAG scheduling honours <code>depends_on</code> and <code>run_if</code>, with independent branches in parallel.</p>
<span class="tagline orange">Real Spark</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M3 12a9 9 0 1 0 18 0 9 9 0 0 0-18 0Z"/><path d="M3.6 9h16.8M3.6 15h16.8M12 3a15 15 0 0 1 0 18 15 15 0 0 1 0-18Z"/></svg></div>
<h3>Unity Catalog protocol for Spark</h3>
<p><code>spark.table("cat.sch.tbl")</code> resolves against MiniLake through the official <code>UCSingleCatalog</code> connector — the same protocol Spark speaks to a real workspace.</p>
<span class="tagline blue">Wire-compatible</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x="2.5" y="4" width="19" height="15" rx="2"/><path d="M2.5 9h19M7 14h5"/></svg></div>
<h3>A built-in SQL workspace</h3>
<p>An Athena-style editor at <code>/ui</code>: Monaco with catalog-aware completion, a virtualized result grid, charts, CSV/JSON export, saved queries, query history — and an embedded JupyterLab.</p>
<span class="tagline blue">Batteries included</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2 3 6.5v11L12 22l9-4.5v-11L12 2Z"/><path d="M7.5 9.2v5.3L12 16.8M16.5 9.2v5.3L12 16.8M12 7v9.8"/></svg></div>
<h3>Terraform & Asset Bundles</h3>
<p>Point the <code>databricks</code> provider at localhost and <code>terraform apply</code> creates real catalogs. Verified on every test run: the real provider is driven through <code>apply</code>, <code>plan</code> and <code>destroy</code>, and a second plan has to come back empty. <code>databricks bundle deploy</code> and <code>bundle run</code> work end to end — jobs execute for real.</p>
<span class="tagline blue">Wire-compatible</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M9 3h6M12 3v4"/><rect x="4" y="7" width="16" height="14" rx="3"/><path d="M9 13h.01M15 13h.01M9 17h6"/></svg></div>
<h3>An MCP server for agents</h3>
<p>67 tools, 8 resources and 4 prompts at <code>/mcp</code> — including composites that collapse a five-call sequence into one, and a SQL-dialect resource that stops agents writing Spark SQL.</p>
<span class="tagline">Real execution</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M20 12a8 8 0 1 1-3-6.2"/><path d="M20 4v5h-5"/></svg></div>
<h3>Designed for CI</h3>
<p>One <code>POST /_minilake/reset</code> gives every test a clean workspace without restarting the container. <code>/health</code>, <code>/ready</code> and <code>/services</code> round out the control plane.</p>
<span class="tagline">Test friendly</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3v10M8 7l4-4 4 4"/><path d="M4 15v3a3 3 0 0 0 3 3h10a3 3 0 0 0 3-3v-3"/></svg></div>
<h3>Workspace, DBFS, Files, Secrets</h3>
<p>File-backed notebook and file storage with chunked uploads. Secrets are real CRUD whose values are only ever resolvable inside a job's environment — exactly like Databricks.</p>
<span class="tagline">Real execution</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10Z"/><path d="m9 12 2 2 4-4"/></svg></div>
<h3>Air-gapped by design</h3>
<p>DuckDB's <code>delta</code> extension and the Delta / Unity Catalog jars are baked in at build time. The image downloads nothing at runtime — provable with <code>docker run --network none</code>.</p>
<span class="tagline">Offline ready</span>
</article>
<article class="card rv">
<div class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9"/><path d="M12 8v5M12 16h.01"/></svg></div>
<h3>Databricks-shaped errors</h3>
<p>Failures come back as <code>{"error_code", "message"}</code>, so the SDK raises its normal typed exceptions. Anything out of scope returns a loud <code>501 NOT_IMPLEMENTED</code> instead of a convincing lie.</p>
<span class="tagline blue">Wire-compatible</span>
</article>
</div>
</div>
</section>
<!-- ============ CODE ============ -->
<section class="section" id="code">
<div class="wrap">
<div class="split">
<div class="rv">
<span class="kicker">Zero code changes</span>
<h2 style="font-size:clamp(30px,3.6vw,42px);margin-top:14px">Change the host. That's the migration.</h2>
<p style="margin-top:16px;font-size:18px;color:var(--text-muted)">
MiniLake speaks the Databricks REST API on the wire, so every client you already use keeps working —
the same calls, the same response shapes, the same typed errors.
</p>
<ul class="checks">
<li><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9"/><path d="m8 12 3 3 5-6"/></svg><span><b>Any token is accepted.</b> No sign-up, no PAT, no OAuth dance to develop against.</span></li>
<li><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9"/><path d="m8 12 3 3 5-6"/></svg><span><b>Types round-trip.</b> <code>STRING</code>, <code>LONG</code>, <code>DECIMAL(10,2)</code>, <code>ARRAY<T></code>, <code>MAP</code> and <code>STRUCT</code> map to DuckDB and come back as the SDK's <code>ColumnInfo</code>.</span></li>
<li><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9"/><path d="m8 12 3 3 5-6"/></svg><span><b>Physical truth wins.</b> Declared column types that disagree with the files lose, so mismatches are visible instead of believed.</span></li>
<li><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9"/><path d="m8 12 3 3 5-6"/></svg><span><b>Persistence when you want it.</b> <code>MINILAKE_PERSIST=1</code> snapshots state on shutdown and restores it on start.</span></li>
</ul>
</div>
<div class="rv">
<div class="tabs" role="tablist" aria-label="Code examples">
<button class="tab" role="tab" aria-selected="true" data-panel="p-sdk">Python SDK</button>
<button class="tab" role="tab" aria-selected="false" data-panel="p-spark">Spark & Delta</button>
<button class="tab" role="tab" aria-selected="false" data-panel="p-tf">Terraform</button>
<button class="tab" role="tab" aria-selected="false" data-panel="p-bundle">Asset Bundles</button>
<button class="tab" role="tab" aria-selected="false" data-panel="p-curl">curl</button>
</div>
<div class="window">
<div class="window-bar">
<span class="dots"><i></i><i></i><i></i></span>
<span class="window-title" id="win-title">quickstart.py</span>
<button class="copy" data-copy=".panel:not([hidden]) code" aria-label="Copy code">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="12" height="12" rx="2"/><path d="M5 15V5a2 2 0 0 1 2-2h10"/></svg>
Copy
</button>
</div>
<pre class="panel" id="p-sdk" data-lang="python" data-title="quickstart.py"><code>from databricks.sdk import WorkspaceClient
from databricks.sdk.service.catalog import ColumnInfo, TableType
# The only line that differs from production
w = WorkspaceClient(host="http://localhost:8000", token="dev")
w.catalogs.create(name="sales")
w.schemas.create(name="store", catalog_name="sales")
w.tables.create(
name="orders", catalog_name="sales", schema_name="store",
table_type=TableType.MANAGED,
data_source_format="DELTA", storage_location="/data/sales/store/orders",
columns=[
ColumnInfo(name="id", type_text="BIGINT"),
ColumnInfo(name="customer", type_text="STRING"),
ColumnInfo(name="amount", type_text="DECIMAL(10,2)"),
],
)
wh = w.warehouses.create(name="dev", cluster_size="Small")
w.statement_execution.execute_statement(
warehouse_id=wh.id,
statement="INSERT INTO sales.store.orders VALUES (1, 'Ana', 459.90)",
)
result = w.statement_execution.execute_statement(
warehouse_id=wh.id,
statement="SELECT customer, amount FROM sales.store.orders",
)
print(result.result.data_array) # [['Ana', '459.90']] — really stored</code></pre>
<pre class="panel" id="p-spark" hidden data-lang="python" data-title="delta_job.py"><code>from pyspark.sql import SparkSession
UC = "http://localhost:8000"
spark = (
SparkSession.builder
.config("spark.sql.extensions", "io.delta.sql.DeltaSparkSessionExtension")
# Unity Catalog connector — three-part names resolve against MiniLake
.config("spark.sql.catalog.spark_catalog", "io.unitycatalog.spark.UCSingleCatalog")
.config("spark.sql.catalog.spark_catalog.uri", UC)
.config("spark.sql.catalog.sales", "io.unitycatalog.spark.UCSingleCatalog")
.config("spark.sql.catalog.sales.uri", UC)
.getOrCreate()
)
# Real Delta files: parquet + _delta_log/, written by real Spark
spark.createDataFrame([(1, "a"), (2, "b")], ["id", "name"]) \
.write.format("delta").mode("overwrite").save("/data/delta/sales/store/events")
spark.sql("INSERT INTO sales.store.events VALUES (3, 'c')")
print(spark.table("sales.store.events").count()) # 3
# ...and the same bytes are readable through MiniLake's SQL API:
# SELECT e.name, o.customer
# FROM sales.store.events e JOIN sales.store.orders o ON o.id = e.id</code></pre>
<pre class="panel" id="p-tf" hidden data-lang="hcl" data-title="main.tf"><code>provider "databricks" {
host = "http://localhost:8000"
token = "dev"
}
resource "databricks_catalog" "sandbox" {
name = "sandbox"
comment = "Local sandbox catalog"
}
resource "databricks_schema" "things" {
catalog_name = databricks_catalog.sandbox.name
name = "things"
}
resource "databricks_sql_endpoint" "compute" {
name = "local-compute"
cluster_size = "Small"
}
# terraform apply -> creates real catalogs and real DuckDB databases
# terraform destroy -> removes them
# Resources backed by APIs MiniLake does not emulate fail loudly with 501,
# instead of silently pretending to succeed.</code></pre>
<pre class="panel" id="p-bundle" hidden data-lang="yaml" data-title="databricks.yml"><code>bundle:
name: my_pipeline
targets:
dev:
mode: development
workspace:
host: http://localhost:8000
resources:
jobs:
daily_load:
name: daily_load
tasks:
- task_key: main
spark_python_task:
python_file: ../src/load.py
# $ databricks bundle deploy -t dev
# $ databricks bundle run daily_load -t dev
#
# The CLI syncs files through the Workspace API, the provider creates the job,
# and `bundle run` executes it on real Spark in a sibling container —
# returning the job's actual output.</code></pre>
<pre class="panel" id="p-curl" hidden data-lang="bash" data-title="terminal"><code># Is it up, and which services answered?
curl http://localhost:8000/_minilake/health
# Create a catalog through the Databricks API surface
curl -X POST http://localhost:8000/api/2.1/unity-catalog/catalogs \
-H 'Content-Type: application/json' \
-d '{"name": "sales"}'
# Run SQL and get real rows back
curl -X POST http://localhost:8000/api/2.0/sql/statements \
-H 'Content-Type: application/json' \
-d '{"warehouse_id": "dev", "statement": "SELECT 42 AS answer"}'
# Give the next test a clean workspace — no restart needed
curl -X POST http://localhost:8000/_minilake/reset</code></pre>
</div>
</div>
</div>
</div>
</section>
<!-- ============ ARCHITECTURE ============ -->
<section class="section alt" id="architecture">
<div class="wrap">
<div class="head center rv">
<span class="kicker">How it works</span>
<h2>One process. One port. Real engines underneath.</h2>
<p>A FastAPI application serves the Databricks REST surface, the web UI and the MCP endpoint together. Behind it sit DuckDB, real Delta files on disk, and Docker for Spark.</p>
</div>
<div class="arch rv">
<svg viewBox="0 0 960 430" role="img" aria-label="Architecture: Databricks SDK, CLI, Terraform, PySpark and LLM agents talk to MiniLake on port 8000, which serves the REST API, the web UI and the MCP endpoint, backed by DuckDB, Delta files and Docker-run Spark.">
<defs>
<linearGradient id="core" x1="0" y1="0" x2="1" y2="1">
<stop offset="0" stop-color="#12305A"/><stop offset="1" stop-color="#0A2B63"/>
</linearGradient>
<marker id="arw" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
<path d="M0 0 10 5 0 10z" fill="#9DB2CE"/>
</marker>
</defs>
<text class="cap" x="24" y="26">CLIENTS</text>
<g>
<rect class="box" x="24" y="42" width="212" height="46" rx="10"/>
<text class="lbl" x="42" y="63">databricks-sdk</text><text class="sub" x="42" y="79">WorkspaceClient (Python)</text>
<rect class="box" x="24" y="100" width="212" height="46" rx="10"/>
<text class="lbl" x="42" y="121">Databricks CLI</text><text class="sub" x="42" y="137">bundle deploy · bundle run</text>
<rect class="box" x="24" y="158" width="212" height="46" rx="10"/>
<text class="lbl" x="42" y="179">Terraform provider</text><text class="sub" x="42" y="195">apply · destroy</text>
<rect class="box" x="24" y="216" width="212" height="46" rx="10"/>
<text class="lbl" x="42" y="237">PySpark / JupyterLab</text><text class="sub" x="42" y="253">spark.table("cat.sch.tbl")</text>
<rect class="box" x="24" y="274" width="212" height="46" rx="10"/>
<text class="lbl" x="42" y="295">LLM agents</text><text class="sub" x="42" y="311">Model Context Protocol</text>
<rect class="box" x="24" y="332" width="212" height="46" rx="10"/>
<text class="lbl" x="42" y="353">Browser</text><text class="sub" x="42" y="369">SQL workspace at /ui</text>
</g>
<path class="line" d="M236 65 C 300 65, 300 200, 352 200" marker-end="url(#arw)"/>
<path class="line" d="M236 123 C 300 123, 305 200, 352 200" marker-end="url(#arw)"/>
<path class="line" d="M236 181 C 300 181, 320 200, 352 200" marker-end="url(#arw)"/>
<path class="line" d="M236 239 C 300 239, 320 205, 352 205" marker-end="url(#arw)"/>
<path class="line" d="M236 297 C 300 297, 305 210, 352 210" marker-end="url(#arw)"/>
<path class="line" d="M236 355 C 300 355, 300 215, 352 215" marker-end="url(#arw)"/>
<text class="cap" x="352" y="26">MINILAKE · ONE PROCESS</text>
<rect x="352" y="42" width="256" height="336" rx="18" fill="url(#core)"/>
<text class="wht" x="376" y="76">MiniLake</text>
<text class="wsub" x="376" y="96">FastAPI · uvicorn · :8000</text>
<rect x="376" y="116" width="208" height="52" rx="10" fill="rgba(255,255,255,.08)" stroke="rgba(255,255,255,.16)"/>
<text class="chip" x="392" y="139">/api/2.0 · /api/2.1</text>
<text class="wsub" x="392" y="157">Databricks REST surface</text>
<rect x="376" y="180" width="208" height="52" rx="10" fill="rgba(255,255,255,.08)" stroke="rgba(255,255,255,.16)"/>
<text class="chip" x="392" y="203">/ui · /jupyter</text>
<text class="wsub" x="392" y="221">SQL workspace + notebooks</text>
<rect x="376" y="244" width="208" height="52" rx="10" fill="rgba(245,129,31,.16)" stroke="rgba(245,129,31,.42)"/>
<text class="chip" x="392" y="267">/mcp</text>
<text class="wsub" x="392" y="285">67 tools for agents</text>
<rect x="376" y="308" width="208" height="52" rx="10" fill="rgba(255,255,255,.08)" stroke="rgba(255,255,255,.16)"/>
<text class="chip" x="392" y="331">/_minilake/*</text>
<text class="wsub" x="392" y="349">health · ready · reset</text>
<path class="line" d="M608 120 C 664 120, 668 96, 724 96" marker-end="url(#arw)"/>
<path class="line" d="M608 200 C 664 200, 668 200, 724 200" marker-end="url(#arw)"/>
<path class="line" d="M608 280 C 664 280, 668 304, 724 304" marker-end="url(#arw)"/>
<text class="cap" x="724" y="26">REAL ENGINES</text>
<rect class="box" x="724" y="66" width="212" height="60" rx="12"/>
<text class="lbl" x="744" y="90">DuckDB</text>
<text class="sub" x="744" y="108">one database file per catalog</text>
<rect class="box" x="724" y="170" width="212" height="60" rx="12"/>
<text class="lbl" x="744" y="194">Delta Lake on disk</text>
<text class="sub" x="744" y="212">parquet + _delta_log/</text>
<rect class="box" x="724" y="274" width="212" height="60" rx="12"/>
<text class="lbl" x="744" y="298">Docker → Apache Spark</text>
<text class="sub" x="744" y="316">spark-submit, sibling container</text>
<path class="line" d="M830 230 L 830 274" marker-end="url(#arw)"/>
<path class="line" d="M830 274 L 830 230" marker-end="url(#arw)"/>
<text class="sub" x="724" y="358">Spark writes the files —</text>
<text class="sub" x="724" y="374">DuckDB reads the same bytes</text>
</svg>
</div>
6D2B
</div>
</section>
<!-- ============ MCP BAND ============ -->
<section class="section" id="agents">
<div class="wrap">
<div class="band rv">
<div class="band-grid">
<div>
<span class="kicker">For LLM agents</span>
<h2>Give an agent a lakehouse it can't break.</h2>
<p>
A Databricks workspace is an awkward thing for an agent to drive: every useful action is four calls
deep, half the SQL it writes is the wrong dialect, and failures are silent. MiniLake's MCP server
closes those gaps — and it costs nothing when the agent gets it wrong.
</p>
<ul class="tool-list">
<li>setup_fixture()<em>catalog + schema + warehouse in one idempotent call</em></li>
<li>seed_table()<em>table + rows, exactly the rows you asked for</em></li>
<li>describe_catalog_tree()<em>the whole hierarchy instead of dozens of calls</em></li>
<li>run_python_script()<em>stage, submit to real Spark, poll, return stdout</em></li>
</ul>
<p style="margin-top:24px;font-size:15.5px;color:#93AACD">
Plus 8 resources — including a SQL-dialect guide that stops agents writing Spark SQL at DuckDB —
and 4 prompts that front-load the rules. Tools run through MiniLake's own ASGI stack, so an agent's
error is exactly the error an SDK client would have seen.
</p>
<div class="hero-actions">
<a class="btn btn-dark" href="https://github.com/dmux/minilake/blob/main/docs/mcp/index.md">MCP documentation</a>
<a class="btn btn-outline-light" href="https://github.com/dmux/minilake/blob/main/docs/mcp/tools.md">All 67 tools</a>
</div>
</div>
<div>
<div class="window">
<div class="window-bar">
<span class="dots"><i></i><i></i><i></i></span>
<span class="window-title">register + use</span>
</div>
<pre data-lang="bash"><code># One line to register it with Claude Code
claude mcp add --transport http minilake http://localhost:8000/mcp
# Then just ask:
# "Use minilake: create a sales catalog with a seeded
# orders table, and tell me the total."
# The agent does this — three calls, no glue code:
# setup_fixture({"catalog": "sales", "schema": "store"})
# seed_table({"full_name": "sales.store.orders", ...})
# run_sql({"statement": "SELECT SUM(amount) FROM sales.store.orders"})
# Enable it on the server side:
MINILAKE_MCP=1 minilake --port 8000</code></pre>
</div>
</div>
</div>
</div>
</div>