Skip to content

chore: add brand-styled logo + screenshot assets for adk-docs PR#4

Merged
NormallyGaussian merged 4 commits into
mainfrom
chore/brand-assets-and-docs-fixes
May 1, 2026
Merged

chore: add brand-styled logo + screenshot assets for adk-docs PR#4
NormallyGaussian merged 4 commits into
mainfrom
chore/brand-assets-and-docs-fixes

Conversation

@NormallyGaussian
Copy link
Copy Markdown
Contributor

@NormallyGaussian NormallyGaussian commented May 1, 2026

Adds the two assets the upstream google/adk-docs PR needs to land cleanly:

File What
docs/assets/parallel.png Parallel avatar logo (1080×1080), from assets.parallel.ai/dark-parallel-avatar-1080.png. Carries its own contrast background (dark rounded square with white mark), so it works in both GitHub light and dark modes without needing a <picture> element.
docs/assets/research_agent.png Rendered screenshot of examples/research_agent.py. Uses Parallel's brand fonts (FT System Mono) and palette per assets.parallel.ai/llms.txt: Off-white `#fcfcfa` background, Index black `#1d1b16` body, Signal `#fb631b` prompt accents, Neural `#d8d0bf` trace line.

Plus scripts/render_screenshot.py to regenerate the PNG from docs/screenshot.txt. Fonts download on demand from assets.parallel.ai (gitignored — the CDN rejects the default urllib User-Agent, so the script passes a browser UA).

Also updates the README to embed the logo and screenshot, leads the install snippet with uv add (pip as fallback), and regenerates docs/screenshot.txt against the current public tool names (the previous capture was made against the pre-rename _web_search etc.).

Verification

  • pytest -v → 29/29 passing (no source code changed)
  • ruff check + format --check → clean
  • Manually inspected both PNGs render correctly

Adds the two assets the upstream adk-docs PR needs:

- docs/assets/parallel.png: Parallel symbol logo (1080x1080), copied from
  assets.parallel.ai. Symbol-only (no wordmark) since the catalog already
  shows the partner name as text next to the icon.
- docs/assets/research_agent.png: rendered terminal screenshot of the
  example agent run. Uses Parallel's brand fonts (FT System Mono) and
  palette per assets.parallel.ai/llms.txt: Off-white #fcfcfa background,
  Index black #1d1b16 body text, Signal #fb631b prompt accents, Neural
  #d8d0bf for the trace line.

scripts/render_screenshot.py: regenerates the screenshot PNG from
docs/screenshot.txt. Downloads FT System Mono fonts from
assets.parallel.ai on demand (gitignored, browser-style User-Agent
required to avoid 403 from the asset CDN).

Also regenerates docs/screenshot.txt with current public tool names
(was generated against the previous _underscore-prefixed names).
Now that the assets live in docs/assets/, surface them in the top-level
README so the repo has visual polish and the assets justify their
existence in-tree.
The Parallel symbol is dark-on-transparent, which renders fine in light
mode but disappears in GitHub's dark mode. Add the white variant and
use a <picture> element with prefers-color-scheme so the right mark
renders in each theme.
The dark avatar variant carries its own background (dark rounded square
with white mark), so it renders correctly in both GitHub light and dark
modes without needing a <picture> element. Drops the unneeded white
symbol PNG.

Also leads the install snippet with 'uv add' (with pip as fallback)
since most modern Python tooling is now uv-first.
@NormallyGaussian NormallyGaussian merged commit 613b3c6 into main May 1, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant