# Paint by numbers > How would your photo look as a paint-by-numbers kit? Turn a photo into a numbered outline, a colour key and a painted preview, ready to print and paint by hand. Make a paint-by-numbers kit from your photo: a numbered outline, a colour key with hex codes and amounts, and a painted preview to print. - Page: https://how.box/paint-by-numbers/ - Runs entirely in the browser. - License: HowToolbox's own text and data (titles, explanations, FAQs, tool descriptions and schemas, this file) are CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); AI training and answers are welcome. Attribute "HowToolbox (how.box)" with a link to the page used. Third-party data keeps its own terms; the name and logo are not licensed. Publisher: HowToolbox, contact@how.box. Terms: https://how.box/about/terms/ ## Inputs Answer link: https://how.box/paint-by-numbers/?cm={cm}&ma={ma}&ko={ko}&c={c}&d={d}&s={s}&p={p}&o={o} - `cm` (auto, flat or perceptual): Colour matching: auto, flat or perceptual. Example: `flat`. - `ma` (whole number 0 to 640000): Minimum connected area in source pixels; zero uses the detail setting. Example: `30`. - `ko` (boolean): Keep cartoon ink as printed lines, outside numbered paint regions. Example: `true`. - `c` (whole number 6 to 30): Number of paints, 6–30. Example: `16`. - `d` (whole number 1 to 8): Level of detail, 1–8. Example: `5`. - `s` (whole number 0 to 3): Smoothing, 0–3. Example: `1`. - `p` (a4 or letter): Paper: a4 or letter. Example: `a4`. - `o` (portrait or landscape): Page orientation: portrait or landscape. Example: `portrait`. Example answer: https://how.box/paint-by-numbers/?cm=flat&ma=30&ko=1&c=16&d=5&s=1&p=a4&o=portrait The page computes the answer in the browser: read results from the agent tools below, not from the page HTML. ## Agent tools - `paint_by_numbers_plan`: Plans a paint-by-numbers kit for a picture of source_width_px × source_height_px pixels. - MCP: POST https://how.box/mcp `tools/call` with `{"name":"paint_by_numbers_plan","arguments":{…}}`; input schema in https://how.box/agent-tools.json. ## How it works A paint-by-numbers kit is a picture cut into areas, each marked with the number of a paint. This tool does the cutting for you: it picks the paints that best represent the photo, gives every pixel the nearest paint, joins pixels of the same paint into areas, and draws a line around every area with its number inside. Areas that are too small or too thin to hold a readable number are merged into their neighbour, which is why a lower detail setting gives fewer and larger areas. The key lists each paint with its colour code and the share of the picture it covers; paint the largest shares first and buy more of those colours. The share is the paint's area divided by the whole picture, so a paint covering 2 500 of 25 000 cells is 10 %. Paints are matched by how different two colours look to the eye, not by raw channel values, so the kit keeps the sky blue and the skin warm. The colours on screen and on paper never match perfectly, and mixed paint differs from the hex code; treat the key as a guide and test a colour on scrap paper. ## FAQ **Is my photo uploaded?** No. The kit is made in your browser and the photo never leaves your device. **How many paints should I choose?** Twelve to eighteen suits most photos. Choose 6 to 8 for a child or a first kit, and 24 or more for a detailed portrait. **Why are some parts of my photo missing detail?** Areas too small or too thin to hold a number are merged into a neighbour. Raise the detail setting for smaller areas; the page keeps the outline within what one printed page can hold. **How do I print it at the right size?** Choose Print, set the scale to 100 % or Actual size and turn off Fit to page. You can also download the pages as a PDF or as images. **Can I mix the paints from basic colours?** Yes. The key gives each colour as a hex code you can compare with your paints. Start from white and add a little of the darker paint at a time, and test on scrap paper. **What picture works best?** A sharp photo with a clear subject and some contrast. Busy backgrounds make many small areas, so crop closely or lower the detail. More: [HowToolbox index](https://how.box/llms.txt) · [Agent Skill](https://how.box/skill.md) · [agent terms](https://how.box/about/agents/)