Skip to content

Convert Claude Code or Codex into the most intelligent Deep Research Agent. Collect, search, and synthesize web research into a persistent, searchable wiki that builds on itself. Hosted API + MCP: hyperresearch.ai

fix: bump README banner to 1752x750 for crisp inline rendering (#14)

Jordan Gibbs86c5391c84a4
diff --git a/README.md b/README.md
index 41e5a2a..efc76d9 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@ hyperresearch install
Then, in a fresh Claude Code session, type `/hyperresearch <anything>`.
-> **Python 3.11–3.13 only.** 3.14 isn't supported yet — Crawl4AI pins `lxml~=5.3` and that line has no cp314 wheels. Tracking the upstream fix at [unclecode/crawl4ai#1903](https://github.com/unclecode/crawl4ai/issues/1903). Use `pyenv install 3.13`, `uv venv -p 3.13 .venv`, or `py -3.13 -m venv .venv` to create a compatible environment.
+> **Python 3.11–3.13 only.** 3.14 isn't supported yet Use `pyenv install 3.13`, `uv venv -p 3.13 .venv`, or `py -3.13 -m venv .venv` to create a compatible environment.
---
diff --git a/assets/_banner_src.png b/assets/_banner_src.png
new file mode 100644
index 0000000..789582f
Binary files /dev/null and b/assets/_banner_src.png differ
diff --git a/assets/_generate_banner.py b/assets/_generate_banner.py
index 4685119..535940d 100644
--- a/assets/_generate_banner.py
+++ b/assets/_generate_banner.py
@@ -1,15 +1,18 @@
-"""Generate banner_social.png at GitHub-social-preview dimensions (1280x640).
+"""Generate banner.png (README inline) and banner_social.png (GitHub social preview).
-Takes the original pixel-art wordmark (assets/banner.png, 584x250),
-upscales it 2x with nearest-neighbor to preserve the chunky pixel
-aesthetic, and places it centered on a 1280x640 dark canvas matching
-the benchmark chart's background color so the README header + social
-preview + Star History icon all read as one visual system.
+Source: assets/_banner_src.png — the pixel-art HYPERRESEARCH wordmark at its
+authored 584x250 resolution. Both output files are derived from it; never
+edit the outputs directly.
-The README still references the original `banner.png` for inline display.
-This script writes a SEPARATE file so the original is never overwritten.
+- banner.png — 3x nearest-neighbor upscale of the source (1752x750). The
+ README references this and renders it at width=700, so the browser
+ downscales (crisp) instead of upscaling (blurry).
+- banner_social.png — wordmark on a 1280x640 dark canvas matching the
+ benchmark chart's background, wordmark filling 92% of the canvas width.
+ Upload at repo Settings → Social preview.
-Output: assets/banner_social.png (for repo Settings → Social preview)
+Re-run when the source wordmark changes:
+ python assets/_generate_banner.py
"""
from pathlib import Path
@@ -17,47 +20,52 @@ from pathlib import Path
from PIL import Image
ASSETS = Path(__file__).parent
-SRC = ASSETS / "banner.png"
-OUT = ASSETS / "banner_social.png"
+SRC = ASSETS / "_banner_src.png"
+README_OUT = ASSETS / "banner.png"
+SOCIAL_OUT = ASSETS / "banner_social.png"
-# Match the chart's dark background so the README header + chart + social
+# Match the chart's dark background so README header + chart + social
# preview share one visual treatment.
BG = (14, 17, 22, 255) # #0E1116
-TARGET_W, TARGET_H = 1280, 640
+SOCIAL_W, SOCIAL_H = 1280, 640
+README_SCALE = 3 # 584x250 → 1752x750
src = Image.open(SRC).convert("RGBA")
-# Upscale the wordmark 2x with nearest-neighbor — preserves the pixel-art
-# chunky letterforms instead of blurring them.
-upscaled = src.resize((src.width * 2, src.height * 2), Image.NEAREST)
-
-# Wordmark should DOMINATE the social card, not float in a sea of dark
-# padding. Fill ~92% of the canvas width — leaves a thin margin so the
-# letterforms breathe but the content reads clearly when platforms
-# crop to tighter aspect ratios than GitHub's native 2:1.
-max_w = int(TARGET_W * 0.92)
-if upscaled.width != max_w:
- ratio = max_w / upscaled.width
- upscaled = upscaled.resize(
- (max_w, int(upscaled.height * ratio)),
+# --- README banner: pure 3x nearest-neighbor upscale, no canvas -----------
+readme_img = src.resize(
+ (src.width * README_SCALE, src.height * README_SCALE),
+ Image.NEAREST,
+)
+readme_img.convert("RGB").save(README_OUT, "PNG", optimize=True)
+print(f"wrote {README_OUT.name} ({readme_img.width}x{readme_img.height})")
+
+# --- Social preview: wordmark on dark canvas at GitHub's required 1280x640
+# Start from the same source, upscale 2x for a base, then resize to fit.
+social_word = src.resize((src.width * 2, src.height * 2), Image.NEAREST)
+
+# Wordmark should DOMINATE the social card. Fill ~92% width.
+max_w = int(SOCIAL_W * 0.92)
+if social_word.width != max_w:
+ ratio = max_w / social_word.width
+ social_word = social_word.resize(
+ (max_w, int(social_word.height * ratio)),
Image.NEAREST,
)
-# Sanity cap at 88% of canvas height (mostly defensive — the source
-# wordmark's 2.34:1 aspect ratio means width usually constrains first).
-max_h = int(TARGET_H * 0.88)
-if upscaled.height > max_h:
- ratio = max_h / upscaled.height
- upscaled = upscaled.resize(
- (int(upscaled.width * ratio), max_h),
+# Defensive height cap (source aspect 2.34:1 means width typically constrains)
+max_h = int(SOCIAL_H * 0.88)
+if social_word.height > max_h:
+ ratio = max_h / social_word.height
+ social_word = social_word.resize(
+ (int(social_word.width * ratio), max_h),
Image.NEAREST,
)
# Compose onto target canvas, centered
-canvas = Image.new("RGBA", (TARGET_W, TARGET_H), BG)
-x = (TARGET_W - upscaled.width) // 2
-y = (TARGET_H - upscaled.height) // 2
-canvas.paste(upscaled, (x, y), upscaled)
-
-canvas.convert("RGB").save(OUT, "PNG", optimize=True)
-print(f"wrote {OUT} ({TARGET_W}x{TARGET_H})")
+canvas = Image.new("RGBA", (SOCIAL_W, SOCIAL_H), BG)
+x = (SOCIAL_W - social_word.width) // 2
+y = (SOCIAL_H - social_word.height) // 2
+canvas.paste(social_word, (x, y), social_word)
+canvas.convert("RGB").save(SOCIAL_OUT, "PNG", optimize=True)
+print(f"wrote {SOCIAL_OUT.name} ({SOCIAL_W}x{SOCIAL_H})")
diff --git a/assets/banner.png b/assets/banner.png
index 789582f..c2b3d99 100644
Binary files a/assets/banner.png and b/assets/banner.png differ