Render any input as a portico – a three-layer ASCII visualization.
Project description
Try it online • Try it locally • Example • Inputs • Customization
About
portico renders input as a three-layered visual abstraction.
- An LLM reads your input, classifies it, and decomposes it into three layers
_ii^: roof, pillars, base. - The renderer turns those layers into a fixed ASCII in the shape of a portico.
- It builds a tiny monument for the thing you're trying to understand.
| Glyph | Layer | Meaning |
|---|---|---|
^ |
Roof | The unifying idea |
ii |
Pillars | The load-bearing components |
_ |
Base | The foundation everything rests on |
Try it locally
Install
uv tool install portico-cli
portico README.md
portico https://example.com/article
portico ./src --no-legend
echo "your text here" | portico -
Try it online
Run portico in your browser, no install required:
–> Hugging Face Space <–
The space uses 🦙 Llama 3.3 70B via Groq. Paste input and render.
Example
portico "https://en.wikipedia.org/wiki/Transformer_(deep_learning_architecture)"
── encyclopedia article: Transformer ─────────────────────────────────────
◆ ◆
^^^ ▲ ^^^
╔══════════════════════════════════════════════════════════════╗
║ Attention Is All You Need ║
╚══════════════════════════════════════════════════════════════╝
////º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~\\\\
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
▀██▀ ▀██▀ ▀██▀ ▀██▀ ▀██▀
██ ██ ██ ██ ██
██ ██ ██ ██ ██
RNN to Core Training Variants and Broad
Transformer Architecture Paradigm Efficiency Applications
██ ██ ██ ██ ██
██ ██ ██ ██ ██
▄██▄ ▄██▄ ▄██▄ ▄██▄ ▄██▄
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
╔════════════════════════════════════════════════════════════════════════╗
║ Multi-head Attention ║
╚════════════════════════════════════════════════════════════════════════╝
legend:
^ Attention Is All You Need: Replacing recurrence with multi-head self-
attention enables parallel, scalable sequence modelling.
ii RNN to Transformer: Sequential limitations of RNNs and seq2seq models
motivated the shift to parallel attention.
ii Core Architecture: Tokenization, positional encoding, encoder and decoder
layers form the transformer's structure.
ii Training Paradigm: Large-scale self-supervised pretraining followed by
task-specific fine-tuning drives performance.
ii Variants and Efficiency: Encoder-only, decoder-only, and encoder-decoder
designs, plus optimizations like FlashAttention and KV caching, adapt the
architecture to diverse needs.
ii Broad Applications: Transformers have expanded from NLP to vision, audio,
robotics, and multimodal generation.
_ Multi-head Attention: Scaled dot-product multi-head attention is the
mathematical substrate every transformer component rests on.
─────────────────────────────────────────────────────── built with _ii^ ──
Run with claude-sonnet-4-6.
Inputs
- Raw text or stdin
- Local files and directories
- URLs (page content is extracted)
- Git repositories
When an input doesn't fit a three-layer shape – poems, flat lists, gibberish – portico refuses honestly rather than fake one.
Customization
| Flag | What it does |
|---|---|
--no-legend |
Hide the per-layer summary (legend renders by default) |
--reapex=N |
Pin the apex to seed N (random by default; pool of 600+ variants) |
--json |
Emit the analyzer's JSON instead of rendering |
--diagnose |
Print a pipeline report (input type, model, fit quality) and exit |
Run portico --help for the full list.
Apex
The apex is the ornament crowning the portico -- picked at render time from a pool of 600+ variants.
🎲 --reapex=SEED pins a specific composition to reproduce.
portico https://0trm.blog/data-science-at-camp-nou/ --reapex=0
── essay: Data Science at Camp Nou ─────────────────
▲ * ▲
~~~ ▲ ~~~
╔════════════════════════════════════════╗
║ Data-Driven Ticketing ║
╚════════════════════════════════════════╝
////º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~\\\\
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
▀██▀ ▀██▀ ▀██▀
██ ██ ██
██ ██ ██
Analytics Experimentation Predictive
██ ██ Modeling
██ ██ ██
██ ██ ██
▄██▄ ▄██▄ ▄██▄
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
╔══════════════════════════════════════════════════╗
║ Fan Behavior ║
╚══════════════════════════════════════════════════╝
portico https://0trm.blog/data-science-at-camp-nou/ --reapex=1
── essay: Data Science at Camp Nou ─────────────────
◆ ◆
═══ ◆ ═══
╔════════════════════════════════════════╗
║ Data-Driven Ticketing ║
╚════════════════════════════════════════╝
////º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~\\\\
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
▀██▀ ▀██▀ ▀██▀
██ ██ ██
██ ██ ██
Analytics Experimentation Predictive
██ ██ Modeling
██ ██ ██
██ ██ ██
▄██▄ ▄██▄ ▄██▄
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
╔══════════════════════════════════════════════════╗
║ Fan Behavior ║
╚══════════════════════════════════════════════════╝
portico https://0trm.blog/data-science-at-camp-nou/ --reapex=7
── essay: Data Science at Camp Nou ─────────────────
· · ·
░░░ ▲ ░░░
╔════════════════════════════════════════╗
║ Data-Driven Ticketing ║
╚════════════════════════════════════════╝
////º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~~º~\\\\
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
▀██▀ ▀██▀ ▀██▀
██ ██ ██
██ ██ ██
Analytics Experimentation Predictive
██ ██ Modeling
██ ██ ██
██ ██ ██
▄██▄ ▄██▄ ▄██▄
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
╔══════════════════════════════════════════════════╗
║ Fan Behavior ║
╚══════════════════════════════════════════════════╝
License
MIT
Built by with AI.
© 2026 trm
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
portico_cli-0.1.6.tar.gz
(24.4 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file portico_cli-0.1.6.tar.gz.
File metadata
- Download URL: portico_cli-0.1.6.tar.gz
- Upload date:
- Size: 24.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
44917192ea34b5a78f326069bde047a2bb22712e5c4f7cc46ae8654d9deb430d
|
|
| MD5 |
1cf4146bd677287b71aec0889f6c617e
|
|
| BLAKE2b-256 |
a556492c3f75ba92b983da93bd0f54f98e2f32c558e031b42fb6d83946422812
|
File details
Details for the file portico_cli-0.1.6-py3-none-any.whl.
File metadata
- Download URL: portico_cli-0.1.6-py3-none-any.whl
- Upload date:
- Size: 32.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
360853becb8a3322b6cb66f8b3933f542ba02bed680edc92026c119b49362db0
|
|
| MD5 |
3678a2d6e2abb9803c2c58c3c5896414
|
|
| BLAKE2b-256 |
d22b36d969667eeafae3815598958a8e35bf01d09aff53f8944b63426427b615
|
