mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
561 lines
24 KiB
HTML
561 lines
24 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>modal-image-building</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/modal-image-building.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/modal-image-building">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/modal-image-building.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>modal-image-building</h1><p class="lede">Configuring Modal runtime environments</p><h1>Modal Image Building</h1>
|
|
<p><strong>Use this skill when:</strong></p>
|
|
<ul><li>Configuring Modal runtime environments</li><li>Installing dependencies for Modal functions</li><li>Optimizing image build times</li><li>Working with custom system packages</li><li>Building reproducible deployments</li></ul>
|
|
<h2>Image Basics</h2>
|
|
<h3>Base Images</h3>
|
|
<p>Choose appropriate base image:</p>
|
|
<pre><code class="lang-python">import modal
|
|
|
|
# Debian Slim (recommended for most cases)
|
|
image = modal.Image.debian_slim()
|
|
|
|
# Debian Slim with specific Python version
|
|
image = modal.Image.debian_slim(python_version="3.11")
|
|
|
|
# Ubuntu (when Debian packages unavailable)
|
|
image = modal.Image.ubuntu()</code></pre>
|
|
<h2>Python Package Installation</h2>
|
|
<h3>uv_pip_install (Recommended)</h3>
|
|
<p>Use <code>uv_pip_install</code> for fast, reliable installs:</p>
|
|
<pre><code class="lang-python"># Single package
|
|
image = modal.Image.debian_slim().uv_pip_install("requests")
|
|
|
|
# Multiple packages
|
|
image = modal.Image.debian_slim().uv_pip_install(
|
|
"numpy",
|
|
"pandas",
|
|
"scikit-learn"
|
|
)
|
|
|
|
# With versions
|
|
image = modal.Image.debian_slim().uv_pip_install(
|
|
"torch==2.1.0",
|
|
"transformers==4.35.0",
|
|
"accelerate==0.24.0"
|
|
)
|
|
|
|
# From requirements.txt
|
|
image = modal.Image.debian_slim().uv_pip_install_from_requirements(
|
|
"requirements.txt"
|
|
)</code></pre>
|
|
<h3>Why uv_pip_install</h3>
|
|
<p>Benefits over <code>pip_install</code>:</p>
|
|
<ul><li>10-100x faster dependency resolution</li><li>Better reproducibility</li><li>More reliable conflict resolution</li><li>Lockfile support</li></ul>
|
|
<pre><code class="lang-python"># ❌ SLOWER - Traditional pip
|
|
image = modal.Image.debian_slim().pip_install(
|
|
"torch",
|
|
"transformers"
|
|
) # Can take minutes
|
|
|
|
# ✅ FASTER - uv
|
|
image = modal.Image.debian_slim().uv_pip_install(
|
|
"torch",
|
|
"transformers"
|
|
) # Takes seconds</code></pre>
|
|
<h2>System Dependencies</h2>
|
|
<h3>apt_install</h3>
|
|
<p>Install system packages:</p>
|
|
<pre><code class="lang-python"># Single package
|
|
image = modal.Image.debian_slim().apt_install("ffmpeg")
|
|
|
|
# Multiple packages
|
|
image = modal.Image.debian_slim().apt_install(
|
|
"ffmpeg",
|
|
"libsm6",
|
|
"libxext6",
|
|
"libxrender-dev",
|
|
"libgomp1"
|
|
)
|
|
|
|
# Common combinations
|
|
# For OpenCV
|
|
opencv_image = (
|
|
modal.Image.debian_slim()
|
|
.apt_install("libsm6", "libxext6", "libxrender-dev")
|
|
.uv_pip_install("opencv-python")
|
|
)
|
|
|
|
# For audio processing
|
|
audio_image = (
|
|
modal.Image.debian_slim()
|
|
.apt_install("ffmpeg", "libsndfile1")
|
|
.uv_pip_install("librosa", "soundfile")
|
|
)</code></pre>
|
|
<h2>Custom Commands</h2>
|
|
<h3>run_commands</h3>
|
|
<p>Execute arbitrary shell commands:</p>
|
|
<pre><code class="lang-python"># Download and setup model
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.uv_pip_install("torch")
|
|
.run_commands(
|
|
"mkdir -p /models",
|
|
"wget https://example.com/model.bin -O /models/model.bin"
|
|
)
|
|
)
|
|
|
|
# Build from source
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.apt_install("build-essential", "cmake")
|
|
.run_commands(
|
|
"git clone https://github.com/example/lib.git",
|
|
"cd lib && mkdir build && cd build",
|
|
"cmake .. && make && make install"
|
|
)
|
|
)
|
|
|
|
# Environment setup
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.run_commands(
|
|
"export PATH=/custom/bin:$PATH",
|
|
"echo 'export PATH=/custom/bin:$PATH' >> /root/.bashrc"
|
|
)
|
|
)</code></pre>
|
|
<h2>Layering and Caching</h2>
|
|
<h3>Build Layers Efficiently</h3>
|
|
<p>Order operations for optimal caching:</p>
|
|
<pre><code class="lang-python"># ✅ GOOD - System deps first (change rarely)
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.apt_install("ffmpeg", "libsm6") # Cached
|
|
.uv_pip_install("opencv-python") # Cached if deps unchanged
|
|
.copy_local_file("config.yaml", "/app/config.yaml") # Changes often
|
|
)
|
|
|
|
# ❌ BAD - Frequently changing layers first
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.copy_local_file("config.yaml", "/app/config.yaml") # Invalidates cache!
|
|
.apt_install("ffmpeg") # Has to rebuild every time
|
|
.uv_pip_install("opencv-python")
|
|
)</code></pre>
|
|
<h3>Separate Concerns</h3>
|
|
<p>Split rarely-changing from frequently-changing:</p>
|
|
<pre><code class="lang-python"># Base image (changes rarely)
|
|
base_image = (
|
|
modal.Image.debian_slim()
|
|
.apt_install("ffmpeg", "libsm6")
|
|
.uv_pip_install(
|
|
"torch==2.1.0",
|
|
"transformers==4.35.0"
|
|
)
|
|
)
|
|
|
|
# App image (changes frequently)
|
|
app_image = (
|
|
base_image
|
|
.copy_local_dir("./src", "/app/src")
|
|
.copy_local_file("config.yaml", "/app/config.yaml")
|
|
)
|
|
|
|
@app.function(image=app_image)
|
|
def my_function():
|
|
pass</code></pre>
|
|
<h2>Environment Variables</h2>
|
|
<h3>Set Build-Time Variables</h3>
|
|
<p>Configure environment during build:</p>
|
|
<pre><code class="lang-python">image = (
|
|
modal.Image.debian_slim()
|
|
.env({"HF_HOME": "/models/cache"})
|
|
.uv_pip_install("transformers")
|
|
)
|
|
|
|
# Multiple variables
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.env({
|
|
"TRANSFORMERS_CACHE": "/models/transformers",
|
|
"HF_HOME": "/models/huggingface",
|
|
"TORCH_HOME": "/models/torch"
|
|
})
|
|
)</code></pre>
|
|
<h2>Copying Local Files</h2>
|
|
<h3>copy_local_file and copy_local_dir</h3>
|
|
<p>Include local files in image:</p>
|
|
<pre><code class="lang-python"># Single file
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.copy_local_file("config.yaml", "/app/config.yaml")
|
|
)
|
|
|
|
# Directory
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.copy_local_dir("./src", "/app/src")
|
|
.copy_local_dir("./data", "/app/data")
|
|
)
|
|
|
|
# With .gitignore-like filtering
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.copy_local_dir(
|
|
"./src",
|
|
"/app/src",
|
|
ignore=["*.pyc", "__pycache__", "*.log"]
|
|
)
|
|
)</code></pre>
|
|
<h2>Dockerfile Integration</h2>
|
|
<h3>From Dockerfile</h3>
|
|
<p>Use existing Dockerfiles:</p>
|
|
<pre><code class="lang-python"># From Dockerfile in repo
|
|
image = modal.Image.from_dockerfile("Dockerfile")
|
|
|
|
# From Dockerfile with context
|
|
image = modal.Image.from_dockerfile(
|
|
"docker/Dockerfile",
|
|
context_mount=modal.Mount.from_local_dir(".", remote_path="/context")
|
|
)
|
|
|
|
# From Dockerfile with build args
|
|
image = modal.Image.from_dockerfile(
|
|
"Dockerfile",
|
|
build_args={"PYTHON_VERSION": "3.11"}
|
|
)</code></pre>
|
|
<h2>Complete Examples</h2>
|
|
<h3>ML Image</h3>
|
|
<p>Comprehensive ML environment:</p>
|
|
<pre><code class="lang-python">ml_image = (
|
|
modal.Image.debian_slim(python_version="3.11")
|
|
.apt_install(
|
|
"git",
|
|
"wget",
|
|
"libsm6",
|
|
"libxext6"
|
|
)
|
|
.uv_pip_install(
|
|
"torch==2.1.0",
|
|
"torchvision==0.16.0",
|
|
"transformers==4.35.0",
|
|
"accelerate==0.24.0",
|
|
"bitsandbytes==0.41.0",
|
|
"datasets==2.14.0",
|
|
"evaluate==0.4.1",
|
|
"tensorboard==2.15.0"
|
|
)
|
|
.env({
|
|
"HF_HOME": "/cache/huggingface",
|
|
"TORCH_HOME": "/cache/torch"
|
|
})
|
|
)</code></pre>
|
|
<h3>Data Processing Image</h3>
|
|
<p>ETL/data science environment:</p>
|
|
<pre><code class="lang-python">data_image = (
|
|
modal.Image.debian_slim(python_version="3.11")
|
|
.apt_install("postgresql-client", "libpq-dev")
|
|
.uv_pip_install(
|
|
"pandas==2.1.0",
|
|
"numpy==1.24.0",
|
|
"sqlalchemy==2.0.0",
|
|
"psycopg2-binary==2.9.9",
|
|
"pyarrow==13.0.0",
|
|
"duckdb==0.9.0"
|
|
)
|
|
)</code></pre>
|
|
<h3>Web Scraping Image</h3>
|
|
<p>Browser automation environment:</p>
|
|
<pre><code class="lang-python">scraping_image = (
|
|
modal.Image.debian_slim()
|
|
.apt_install(
|
|
"chromium",
|
|
"chromium-driver"
|
|
)
|
|
.uv_pip_install(
|
|
"selenium==4.15.0",
|
|
"beautifulsoup4==4.12.0",
|
|
"requests==2.31.0",
|
|
"lxml==4.9.0"
|
|
)
|
|
)</code></pre>
|
|
<h2>Debugging Images</h2>
|
|
<h3>Interactive Debugging</h3>
|
|
<p>Test image builds:</p>
|
|
<pre><code class="lang-python">@app.function(image=my_image)
|
|
def debug_image():
|
|
import subprocess
|
|
import sys
|
|
|
|
# Check Python version
|
|
print(f"Python: {sys.version}")
|
|
|
|
# Check installed packages
|
|
result = subprocess.run(
|
|
["pip", "list"],
|
|
capture_output=True,
|
|
text=True
|
|
)
|
|
print(result.stdout)
|
|
|
|
# Check system packages
|
|
result = subprocess.run(
|
|
["dpkg", "-l"],
|
|
capture_output=True,
|
|
text=True
|
|
)
|
|
print(result.stdout[:1000]) # First 1000 chars
|
|
|
|
return "Debug complete"</code></pre>
|
|
<h2>Anti-Patterns to Avoid</h2>
|
|
<p><strong>DON'T use pip_install when uv_pip_install works:</strong></p>
|
|
<pre><code class="lang-python"># ❌ SLOW
|
|
image = modal.Image.debian_slim().pip_install("torch", "transformers")
|
|
|
|
# ✅ FAST
|
|
image = modal.Image.debian_slim().uv_pip_install("torch", "transformers")</code></pre>
|
|
<p><strong>DON'T copy unnecessary files:</strong></p>
|
|
<pre><code class="lang-python"># ❌ BAD - Copies everything including .git, node_modules
|
|
image = modal.Image.debian_slim().copy_local_dir(".", "/app")
|
|
|
|
# ✅ GOOD - Only copy what's needed
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.copy_local_dir(
|
|
"./src",
|
|
"/app/src",
|
|
ignore=["*.pyc", "__pycache__", ".git", "node_modules"]
|
|
)
|
|
)</code></pre>
|
|
<p><strong>DON'T install packages without versions in production:</strong></p>
|
|
<pre><code class="lang-python"># ❌ BAD - Non-reproducible
|
|
image = modal.Image.debian_slim().uv_pip_install("torch", "transformers")
|
|
|
|
# ✅ GOOD - Pinned versions
|
|
image = modal.Image.debian_slim().uv_pip_install(
|
|
"torch==2.1.0",
|
|
"transformers==4.35.0"
|
|
)</code></pre>
|
|
<p><strong>DON'T put changing layers early:</strong></p>
|
|
<pre><code class="lang-python"># ❌ BAD - Invalidates cache on every code change
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.copy_local_dir("./src", "/app") # Changes often!
|
|
.uv_pip_install("torch") # Has to rebuild
|
|
)
|
|
|
|
# ✅ GOOD - Stable layers first
|
|
image = (
|
|
modal.Image.debian_slim()
|
|
.uv_pip_install("torch") # Cached
|
|
.copy_local_dir("./src", "/app") # Only this rebuilds
|
|
)</code></pre>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><strong>modal-functions-basics.md</strong> - Using images in functions</li><li><strong>modal-gpu-workloads.md</strong> - ML/GPU-specific images</li><li><strong>modal-volumes-secrets.md</strong> - Baking data vs volumes</li></ul>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/modal-image-building.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |