Skip to content

Repository files navigation

PostEx

Let every study have its own visual identity.

PostEx is an open-source, agent-friendly academic-poster toolkit for Codex, Claude Code, and the command line. Version 0.2 introduces Palette Fusion: it combines evidence-linked scientific content with natural-language inspiration, reference images, named themes, brand systems, or manual colors to create a coherent poster identity—not merely a recolored template.

Status: 0.2.0a2. Palette DNA, Poster Brief, three-direction fusion planning, figure-edit approval, design locks, explainable rationale, and approval-bound Palette DNA rendering are runnable. The Bioinformatics Pipeline family remains the production-renderable family while the remaining template families are developed.

See PostEx in action

1. Turn visual inspiration into Palette DNA

The primary visual direction on this page is a Paimon-inspired cape-gradient Visual Signature: midnight navy, layered cape blues, luminous ice blue, warm starlight gold, and a soft pearl canvas. No character artwork is bundled. PostEx translates the inspiration into an original, research-ready system of color roles, gradients, hierarchy, rhythm, cards, connectors, and emphasis.

PostEx Palette Fusion Studio with three palette directions and three intelligent layout directions

PostEx can build Palette DNA through several complementary routes:

  • Natural-language recognition: descriptions such as celestial, friendly, refined, airy are parsed into temperature, luminance, saturation, contrast, visual rhythm, hierarchy, and component behavior.
  • User-image recognition: region-aware CIELAB sampling identifies dominant, supporting, and accent colors from meaningful image regions; contrast repair and print simulation turn them into usable poster roles instead of simply averaging pixels.
  • Named-theme interpretation: a theme is abstracted into visual characteristics and a rights-safe design language; source character or game artwork is not required or redistributed.
  • Brand and manual input: institutional or user-supplied colors are mapped to semantic roles, completed with accessible neutrals, and checked for contrast, grayscale, color-vision, and print behavior.

Every route records provenance and produces role-based colors, usage ratios, component behavior, semantic locks, and three approval-ready expression levels: Academic Safe, Balanced Fusion, and Visual Signature. The Paimon-inspired Visual Signature is the hero direction here; the other two demonstrate how the same evidence plan can support quieter alternatives. Open the generated Palette Studio HTML, inspect the fusion candidates, or read the design rationale.

2. Fuse a fictional paper with a signature visual identity

The AURORA-12 golden example starts from a fully fictional, CC0 five-page manuscript. Its primary output is the Paimon-inspired Visual Signature below: evidence-linked, editable, print-aware, and approval-bound from Palette DNA through final rendering.

AURORA-12 fictional bioinformatics poster in the Paimon-inspired cape-gradient Visual Signature

The same approved evidence plan can also be expressed through PostEx Academic Safe or a user-image Balanced Fusion. These are supporting comparisons, not the lead identity:

Three AURORA-12 evidence-linked posters generated by PostEx

Input: fictional manuscript PDF · Research type: synthetic bioinformatics benchmark · Content mode: traceable · Primary output: Paimon-inspired PPTX · Supporting outputs: Academic Safe PPTX · image-fusion PPTX · Audit: evidence · approvals

3. Keep one design language across print sizes

The Paimon-inspired AURORA-12 design is rendered and preflighted independently in A0, A1, and 36×48-inch landscape formats rather than relying on blind page scaling. Typography, margins, cards, gradients, and figure density are adapted to each physical size while the Palette DNA remains recognizable.

PostEx Bioinformatics Pipeline template family shown in A0, A1, and 36 by 48 inch variants

4. Evaluate evidence structure across study types

Both panels below are generated from CC0 fictional studies: AURORA-12 exercises a bioinformatics benchmark structure, while LUMEN-24 exercises an observational cohort structure. They test must-keep facts, evidence anchors, source contracts, and interpretation boundaries—not just visual similarity—and share the Paimon-inspired design language used throughout this page.

PostEx evaluation previews across bioinformatics and observational biomedical papers

Inspect the AURORA-12 manuscript and evidence or the LUMEN-24 fictional source and content plan.

5. Give one paper a knightly visual signature

What if a scientific poster could feel decisive, kinetic, and memorable—without sacrificing evidence discipline? This Varka-inspired case translates charcoal armor, wolf teal, Anemo cyan, ivory, and antique gold into a role-based Visual Signature with a clear results axis and restrained high-energy accents.

Varka visual source transformed into Palette DNA and an evidence-linked PostEx poster

PostEx does not paste character art into the poster or recolor scientific figures. It abstracts the reference into hierarchy, contrast, rhythm, component behavior, and semantic color roles; the source figures remain pixel-locked while the surrounding design becomes unmistakably its own.

Route: named-theme interpretation + region-aware image sampling · Palette: Visual Signature · Structure: Visual Journey · Full view: poster PNG · Reference: HoYoverse-hosted Varka illustration

6. Turn architecture into an intelligent poster system

The Temple of Heaven case starts with a real photograph, but the outcome is not a photo-themed template. PostEx recognizes glazed-tile blue, vermilion structure, gilded details, jade-painted eaves, and pale stone—then turns those observations into a print-safe Balanced Fusion and a calm, result-first reading path.

Temple of Heaven photograph transformed into Palette DNA and an evidence-linked PostEx poster

The building's ceremonial axis becomes information flow; tiered roofs become restrained header rhythm; white stone becomes breathing space. The reference image shapes the design language without appearing inside the scientific poster itself.

Route: user-image recognition + semantic interpretation · Palette: Balanced Fusion · Structure: Visual Journey · Full view: poster PNG · Reference: Hall of Prayer for Good Harvests photograph

Your study should not look like everyone else's

Give PostEx a paper and a visual idea—a mood, a place, an image, a brand, or a few colors. It returns traceable content, approval-ready Palette DNA, intelligent layout fusion, an editable PPTX, print output, and the evidence trail behind every major decision.

If you want academic software to be both trustworthy and visually ambitious, star PostEx on GitHub.

Alpha boundary: the full-size AURORA-12 posters use one approved Visual Journey structure in the production-renderable Bioinformatics Pipeline family. Palette Fusion also generates three structural candidates and rationale; rendering every structural direction and every template family is still in development.

What makes PostEx different

  • Palette DNA: natural language, user images, named themes, brand colors, or manual colors become role-based systems with usage ratios, component language, provenance, simulations, and semantic locks.
  • Intelligent fusion: Hero Result, Visual Journey, and Editorial Story proposals respond to both content and palette character.
  • Explainable design: every fusion proposal states why it chose its visual anchor, structure, emphasis, and guardrails.
  • User-owned decisions: cloud upload, deletion, figure editing, palette application, poster structure, and semantic-color unlock are digest-bound approvals.
  • Evidence first: claim IDs and numerical evidence survive rewriting, translation, and visual redesign.
  • Editable and print-aware: PPTX is canonical; PDF, PNG, preflight, evidence, and rationale reports accompany delivery.

PostEx v0.2 still prioritizes bioinformatics and observational biomedical research, Chinese/English input and output, and A0, A1, and 36×48-inch landscape posters.

Quick start

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

postex brief-questions
postex validate examples/aurora-synthetic/project-paimon.yaml
postex palette-plan examples/palette-fusion/project.yaml
postex fusion-plan examples/palette-fusion/project.yaml
python -m unittest discover -s tests -v
python scripts/check_repository.py

The two design commands create:

examples/palette-fusion/outputs/fusion/
├── fusion-candidates.json
└── design-rationale.html
examples/palette-fusion/outputs/palette/
├── palette-candidates.json
└── palette-studio.html

The end-to-end renderer is exercised by the synthetic golden example:

postex generate examples/aurora-synthetic/project-paimon.yaml \
  --artifact-workspace /path/to/initialized/artifact-tool-workspace \
  --office-executable /path/to/soffice

Palette Fusion workflow

local inspect
→ Poster Brief and logo decision
→ evidence-linked content plan
→ hero-result approval
→ deletion and figure-edit approvals
→ three Palette DNA previews
→ palette approval
→ three structural fusion directions
→ structure approval
→ PPTX/PDF/PNG render
→ distance, accessibility, print, and evidence preflight
→ evidence, approval, diff, and design-rationale reports

Changing an approved proposal changes its digest and invalidates the approval. Locked copy, figures, regions, colors, layouts, or logos cannot be silently changed in later iterations.

Repository map

src/postex/              shared Python core
schemas/                 v0.1-compatible and v0.2 JSON contracts
configs/                 defaults and provider examples
skills/                  Codex and Claude Code skill drafts
assets/templates/        three families × three print sizes
examples/palette-fusion/ runnable design-intelligence example
examples/aurora-synthetic/ CC0 fictional golden example and three poster variants
tests/                   unit and contract tests
evals/                   quality cases and rubric
docs/                    workflows, privacy, rendering, and design contracts
docker/                  container packaging

Compatibility and limits

v0.1 project files remain loadable. The v0.2 alpha generates fusion plans and rationale through the shared Python core; it does not yet promise that all three fusion directions can be rendered by every template family. Raster scientific figures are never recolored automatically. Editable SVG figure variants require a separate scientific-color unlock. Core runnable examples remain independent of proprietary character artwork; the clearly attributed homepage showcase assets are governed separately and are not covered by the repository's Apache-2.0 license.

Licensing

Python code and documentation are Apache-2.0; see LICENSE and NOTICE. Templates, examples, source papers, scientific figures, logos, character artwork, photographs, and homepage showcase assets have independent license records. See the README image provenance before redistribution; never assume the code license covers bundled media.

See PRD.md, ARCHITECTURE.md, SECURITY.md, and CONTRIBUTING.md.

About

Evidence-linked Palette Fusion for distinctive, editable, and print-ready academic posters.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages