pixel-path README

README проекта с github.com/jonwheatley/pixel-path. Одним файлом markdown: README.md.

Pixel Path

A Claude Code skill that turns any two places into a pixel-art fly-through of the real road. Ask Claude for "a pixel path from Bath to Bristol" and it:

Flying through Bath, England, at the moderate level

Bath, England: real streets from OpenStreetMap, art generated with the moderate kit.

What it is for

A first-person, pixel-art view of any real road, built from the real map. Useful wherever you want a real place or route on screen:

What you get

A folder with an index.html. Open it through any static web server and you are moving down the real road:

Three levels of detail

Before anything slow happens, the first step prints an estimate for your route, and the skill asks you to choose. Only the art costs money: $0.18 a picture at RetroDiffusion's rd_pro__default (October 2026). Cost depends on the number of regions (distinct looks along the route), not on distance.

level pictures per region 1 region 2 regions what you get
placeholders 0 $0 $0 code-drawn stand-ins for every picture
sparse 4 $0.72 $1.44 three kinds of building and a tree. Every lot is still filled; mirrored and tinted copies stretch the pictures.
moderate about 14, + 4 landmarks $3.24 $5.76 about ten buildings across the main kinds, two trees, a shrub, a street prop, the four best-known landmarks
detailed about 26, + 10 landmarks $6.48 $11.16 up to six variants of each kind of building, three trees, two shrubs, three street props, ten landmarks

The levels are nested, so moving up a level only pays for the new pictures. The exact quote is free and comes after the bake. Allow about 25% on top for re-rolls: in testing, 10% (Bath) to 34% (Manhattan) of pictures came back cut off or on a background. The cleanup dropped them, and the self-check re-rolled them within the budget.

Examples

Bath to Bristol at moderate (two regions, Georgian Bath, then Victorian Keynsham and Bristol, 32 pictures, $5.76):

Bath to Bristol at moderate

Kyoto Station to Kinkaku-ji, Japan, at sparse (one region, four pictures, $0.72):

Kyoto at sparse

Both runs passed the full self-check, including the sweep: 627 and 345 moving frames, with no sky through or between buildings. The estimate printed after routing matched the exact quote in every test run.

Install

As a plugin. In Claude Code:

/plugin marketplace add jonwheatley/pixel-path
/plugin install pixel-path@pixel-path

By hand. Copy this folder into your skills folder, so that the skill is at ~/.claude/skills/pixel-path/SKILL.md. For a single project, use .claude/skills/pixel-path/ inside it.

Then ask Claude: "make me a pixel path from Paris to Versailles".

Requirements and setup

How it checks itself

The skill doesn't call a route done when the code runs. It calls it done when the pictures pass:

  1. Every building is a solid. Each building is laid along its real line and always gets a shaded end wall, so it never reads as a flat card. A neighbour that joins it paints over the part it covers.

    • Cracks under 3 m are closed.
    • In a dense street, a building mapped far back is pulled up to the sidewalk.
    • A backing building stands behind every gap in a built-up row.
    • A second row of real buildings shows across squares and car parks.
  2. Cleanup. Each picture is cleaned and its backdrop flood-filled away. Holes in facades are filled, including a roof-to-ground gap between two houses drawn in one picture. Pictures that still carry a background, painted sky, a cut-off edge or a sliver are dropped. A contact sheet of every picture is written for Claude to look at.

  3. Layout check. The whole route is laid out exactly as the page will draw it, checking for gaps in street walls and for a building with the same picture as its neighbour.

  4. The sweep. Every 75 m of built-up road, the camera moves and looks straight ahead and 30° to each side. The sky is painted magenta and every building is drawn into a mask, and it counts:

    • sky seen through a building
    • slits of sky between two parts of the same street wall that reach down to the ground

    The 20 worst frames are written side by side with the problem marked.

  5. Review. Claude is told to look at the worst frames and the samples and keep fixing until the sweep is clean.

Credits and licences

The page shows a credits line that must stay visible wherever a fly-through is shown.

Known limits

pixel-path (jonwheatley/pixel-path)

Ищем в базе…

Что это такое?Pixel Path — это навык Claude Code, который превращает реальный маршрут между двумя точками в пролёт от первого лица в пиксель-арте, с настоящими зданиями, рельефом и ориентирами из OpenStreetMap и данных о высоте.
Это отдельное приложение или то, что работает внутри Claude Code?Это навык Claude Code, а не отдельное приложение: вы устанавливаете его в папку навыков Claude и просите у Claude маршрут обычными словами, а результат — это обычная папка с index.html, которую можно открыть через любой статический веб-сервер.
Как мне установить и пользоваться?Установите как плагин Claude Code или скопируйте папку вручную в свою папку навыков, чтобы навык оказался по пути ~/.claude/skills/pixel-path/SKILL.md (или .claude/skills/pixel-path/ для одного проекта), а затем просто попросите Claude построить маршрут, например: «пиксельный путь из Бата в Бристоль».
Что нужно помимо Claude Code?Для сборки заглушечного маршрута достаточно Node 18 или новее; для настоящей сгенерированной графики нужен аккаунт RetroDiffusion с кредитами и API-ключ, заданный как переменная окружения; необязательная самопроверка по скриншотам требует Node 20+ с Playwright и Chromium.
Каковы главные ограничения?Навык строит только маршруты для автомобилей без трафика, людей и погоды; здания, которых нет в OpenStreetMap, получают правдоподобные угаданные формы и высоты; один регион использует один и тот же набор картинок, поэтому длинные улицы повторяются; а Overpass, источник картографических данных, работает медленно и может выходить по таймауту, так что длинный маршрут может строиться до часа.
Видит ли навык мой API-ключ RetroDiffusion?Нет, ключ вы задаёте сами — как переменную окружения или в macOS Keychain; навык никогда не запрашивает его в чате и нигде не выводит.
Сколько стоит сгенерировать маршрут?Деньги уходят только на графику — $0,18 за картинку от RetroDiffusion; маршрут на два региона стоит от $0 (заглушки, нарисованные кодом) до примерно $11,16 на детальном уровне, с до 26 картинками на регион плюс ориентиры.
Как навык проверяет свою работу перед тем, как отдать результат?Он рендерит контактный лист со всеми сгенерированными картинками, раскладывает весь маршрут, чтобы найти разрывы в стенах улиц, затем проходит камерой каждые 75 метров, высматривая небо, просвечивающее сквозь здания, и просит Claude проверить самые проблемные кадры и перегенерировать плохую графику.
Для чего я могу реально использовать сгенерированный пролёт?Уровни с настоящими дорогами для гонок или бесконечных раннеров, видеоотчёты о поездках и контент о путешествиях, фоны для стримов и lo-fi-музыка на повторе, а также прокомментированный псевдо-3D рендерер и конвейер подготовки данных OpenStreetMap, на котором можно учиться или который можно доработать.
Автор
jonwheatley
Размер
6.9 MB
Звёзды
331
Обновлён
КоммитOct 12
Возраст
1 мес
Коммиты · 90 дней