# gh-ascii turns your GitHub profile into an ASCII card

> Enter a handle and get a neofetch-style SVG for your profile README, with live stats.

**Published:** July 12, 2026 | **Area:** Station | **Kind:** Ship | **Crafters:** Cristian Correa

![](https://crafter.run/changelog/gh-ascii/cover.webp)

---

gh-ascii turns a GitHub handle into a neofetch-style SVG card for your profile README: your avatar as ASCII art next to live stats. It is for anyone who wants a profile that stands out without hosting anything. Generate yours at [gh.crafter.run](https://gh.crafter.run).

<Clip src="/changelog/gh-ascii/generate.mp4" poster="/changelog/gh-ascii/generate.webp" size="1280x800" alt="Typing a handle into gh-ascii, generating the dark card, then switching to the light theme" caption="Type a handle, generate, and pick a theme." />

## Your avatar, as ASCII

gh-ascii removes the background behind the subject, then picks characters by how much ink each one covers in the card's font. You can set the detail from 80 to 140 columns, keep the original background, or use any image URL or an uploaded file instead of your avatar.

## Live stats, no API key

Uptime, languages, repos, stars, commits and contributions come from the public GitHub API when the card is generated. Download `dark_mode.svg` and `light_mode.svg`, commit them next to your README and reference them from a `<picture>` element so each theme loads its card.

![Light gh-ascii card with ASCII avatar and GitHub stats, above the download steps](https://crafter.run/changelog/gh-ascii/light-card.webp)

*Both themes download as plain SVG files that live in your repo.*

## Keep it fresh

A committed SVG is a snapshot. The repo ships a GitHub Actions workflow that downloads both themes on a daily cron and commits only when the card changed.

<Mention href="https://github.com/UltimateStrength/ascii-readme" author="Marcos (UltimateStrength)" source="GitHub" quote="Based on and forked from crafter-station/gh-ascii by Crafter Station." />

## Try it

Open [gh.crafter.run](https://gh.crafter.run), or fetch a card directly:

```bash
curl -fL "https://gh.crafter.run/<handle>?theme=dark" -o dark_mode.svg
curl -fL "https://gh.crafter.run/<handle>?theme=light" -o light_mode.svg
```



- `GET /<handle>` with `?theme`, `?cols=40..160`, `?image=<url>` and `?bg=keep`
- `POST /<handle>` to render from a local image up to 10 MB
- An agent mode prompt so your AI assistant can set it up for you
- A daily refresh workflow you can drop into your profile repo

---

**Repositories**

- [crafter-station/gh-ascii](https://github.com/crafter-station/gh-ascii)

**Links**

- [Open gh-ascii](https://gh.crafter.run)

**Sources**

- https://github.com/crafter-station/gh-ascii
- https://gh.crafter.run
- https://github.com/UltimateStrength/ascii-readme
- https://github.com/UltimateStrength/ascii-train

**All changes:** [Markdown index](https://crafter.run/en/changelog/sitemap.md) | [Crafter Station](https://crafter.run)
