pip install nbcraft
nb config set api_key $GEMINI_API_KEY
nb gen -p "a tiny astronaut surfing a banana wave, neon dusk" --ar 16:9 --res 2K

# Stable
pip install nbcraft

# Or from source
git clone https://github.com/jieyefriic/nbcraft
cd nbcraft
pip install -e .

# Gemini (Google AI Studio: https://aistudio.google.com/app/apikey)
nb config set api_key <key>          # or export GEMINI_API_KEY

# DashScope 阿里云 (https://dashscope.console.aliyun.com)
nb config set dashscope_api_key <key>  # or export DASHSCOPE_API_KEY

# Volcengine Ark 火山方舟 (https://console.volcengine.com/ark)
nb config set ark_api_key <key>        # or export ARK_API_KEY

# OpenAI (https://platform.openai.com/api-keys)
nb config set openai_api_key <key>     # or export OPENAI_API_KEY

nb config set openai_base_url https://your-proxy/v1

# Gemini default
nb gen -p "a watercolor portrait of a librarian cat"

# Reference image + aspect ratio + resolution
nb gen -p "make this scene at sunset" -i photo.jpg --ar 16:9 --res 2K -o sunset.png

# Seedream 4.5 — best for posters with embedded Chinese text
nb gen -p "promotional poster, headline 春日上新, soft pastel" --model seedream --ar 3:4 --res 4K

# GPT Image 2 — strong character-level text + agentic reasoning
nb gen -p "minimalist logo with the words Stay Curious" --model gpt --ar 1:1 --res 2K

# Multi-reference fusion (Seedream up to 14)
nb gen -p "outfit from img 1, pose from img 2" -i a.png -i b.png --model seedream

# Generate 4 variations in parallel
nb gen -p "a quiet study room" --repeat 4 -o studies.png
# → studies_1.png, studies_2.png, studies_3.png, studies_4.png

# Prompt from a file
nb gen -p @prompt.txt --model wan-pro --res 4K

# Text-to-video, 5s, 720p, no audio (default)
nb video gen -p "a shiba inu turning under cherry blossoms, slow motion" --ar 16:9

# Image-to-video with first-frame
nb video gen -p "camera dollies in, then orbits the product" -i product.png --duration 8

# Cinema-grade 1080p with synced audio
nb video gen -p "a barista narrates over morning espresso" --res 1080p --duration 10 --audio

# Fast iteration draft
nb video gen -p "rough concept" --model seedance-fast --duration 4

# Submit only (don't wait); check later
nb video gen -p "..." --no-poll
nb video status <task_id>
nb video download <task_id> -o final.mp4

# tasks.jsonl
# {"key": "img1", "prompt": "...", "images": ["ref.png"], "ar": "3:4", "res": "2K"}
# {"key": "img2", "prompt": "..."}

nb batch submit -f tasks.jsonl --poll -o ./output/
nb batch list
nb batch status <job_name>
nb batch download <job_name> -o ./output/

# Infer HTML structure from a UI screenshot
nb rev struct -i screenshot.png -o structure.md

# Describe an image
nb rev desc -i photo.png -p "analyze the color palette"

nb history                    # last 20
nb history -s "poster"        # filter by prompt
nb history <record_id>        # full JSON detail
nb stats                      # totals, success/fail, monthly/daily

nb config set default_model flash       # Picked when --model is omitted
nb config set default_ar 3:4
nb config set default_res 2K
nb config set output_dir ./out
nb config set poll_interval 20          # Batch poll seconds

git clone https://github.com/jieyefriic/nbcraft
cd nbcraft
pip install -e ".[dev]"

pytest                   # run tests
ruff check .             # lint
ruff format .            # format