{"id":50995097,"url":"https://github.com/raphink/panelgen","last_synced_at":"2026-06-20T08:30:34.035Z","repository":{"id":365890888,"uuid":"1274111831","full_name":"raphink/panelgen","owner":"raphink","description":"Generate image panels from YAML + genAI","archived":false,"fork":false,"pushed_at":"2026-06-19T11:13:20.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-19T11:28:14.069Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raphink.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-19T07:29:42.000Z","updated_at":"2026-06-19T11:13:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/raphink/panelgen","commit_stats":null,"previous_names":["raphink/panelgen"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/raphink/panelgen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphink%2Fpanelgen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphink%2Fpanelgen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphink%2Fpanelgen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphink%2Fpanelgen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raphink","download_url":"https://codeload.github.com/raphink/panelgen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphink%2Fpanelgen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34563533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-20T08:30:32.211Z","updated_at":"2026-06-20T08:30:34.026Z","avatar_url":"https://github.com/raphink.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# panelgen\n\n[![checks](https://github.com/raphink/panelgen/actions/workflows/checks.yml/badge.svg?branch=main)](https://github.com/raphink/panelgen/actions/workflows/checks.yml)\n[![release](https://github.com/raphink/panelgen/actions/workflows/release.yml/badge.svg)](https://github.com/raphink/panelgen/actions/workflows/release.yml)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/raphink/panelgen)](https://github.com/raphink/panelgen/blob/main/go.mod)\n[![Go Report Card](https://goreportcard.com/badge/github.com/raphink/panelgen)](https://goreportcard.com/report/github.com/raphink/panelgen)\n[![Go Reference](https://pkg.go.dev/badge/github.com/raphink/panelgen.svg)](https://pkg.go.dev/github.com/raphink/panelgen)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\nAI image series generator. Define scenes and panels in YAML, generate consistent image series with gpt-image-2 via Azure AI Foundry.\n\nSingle static binary. No runtime dependencies. Designed to drop cleanly into agentic pipelines.\n\n## Install\n\n**Homebrew (recommended):**\n```bash\nbrew tap raphink/tap\nbrew install panelgen\n```\n\n**From source:**\n```bash\ngo install github.com/raphink/panelgen@latest\n```\n\n**Binary:**\n```bash\n# Download from GitHub releases\ncurl -L https://github.com/raphink/panelgen/releases/latest/download/panelgen-linux-amd64 \\\n  -o panelgen \u0026\u0026 chmod +x panelgen\n```\n\n**Container:**\n```bash\n# Azure\ndocker run --rm \\\n  -v \"$PWD:/work\" \\\n  -e AZURE_OPENAI_ENDPOINT \\\n  -e AZURE_OPENAI_API_KEY \\\n  panelgen batch --config panelgen.yml\n\n# OpenAI\ndocker run --rm \\\n  -v \"$PWD:/work\" \\\n  -e OPENAI_API_KEY \\\n  panelgen batch --config panelgen.yml\n```\n\n## Requirements\n\n**Azure OpenAI:**\n```bash\nexport AZURE_OPENAI_ENDPOINT=\"https://your-resource.openai.azure.com\"\nexport AZURE_OPENAI_API_KEY=\"your-key\"\nexport AZURE_OPENAI_DEPLOYMENT=\"gpt-image-2\"   # optional, default: gpt-image-2\n```\n\n**Standard OpenAI:**\n```bash\nexport OPENAI_API_KEY=\"your-key\"\nexport OPENAI_MODEL=\"gpt-image-2\"    # optional, default: gpt-image-2\nexport OPENAI_BASE_URL=\"https://api.openai.com\"  # optional, for custom endpoints\n```\n\nProvider is selected automatically: Azure when `AZURE_OPENAI_ENDPOINT` is set, otherwise OpenAI.\n\n## Usage\n\n### Generate a single image\n\n```bash\n# Inline prompt\npanelgen generate \"A clockwork fox in a space suit floating near a Kubernetes cluster\" output.png\n\n# Prompt from file — useful for long prompts or agentic pipelines\npanelgen generate -prompt-file prompt.txt output.png\n\n# With a scene from your config (adds refs, prompt prefix, size defaults)\npanelgen generate -scene space-solo -prompt-file prompt.txt output.png\n\n# With reference images\npanelgen generate \"Same character, different pose\" output.png -ref previous.png\n\n# Size and quality overrides\npanelgen generate \"...\" output.png -size 1536x1024 -quality medium\n\n# Outpainting: expand a square image to landscape\npanelgen generate --quality low --ref square_img.jpg --size 1920x1088 'outpaint the image' landscape_img.jpg\n```\n\n### Batch generation\n\n```bash\n# Generate all panels in panelgen.yml\npanelgen batch\n\n# Specific config file\npanelgen batch -config comic.yml\n\n# Dry run\npanelgen batch -dry-run\n\n# Specific pages\npanelgen batch -pages 1,3,5-10\n\n# Force a new version even if output exists\npanelgen batch -force\n\n# Parallel generation\npanelgen batch -parallel 4\n\n# Quality override\npanelgen batch -quality high\n```\n\n### Lint config\n\n```bash\n# Validate config structure and local file references\npanelgen lint --config panelgen.yml\n\n# Fail on warnings too\npanelgen lint --config panelgen.yml --strict\n```\n\n### Plan / preview\n\n```bash\n# Preview what would be generated without calling the image API\npanelgen plan --config panelgen.yml\n\n# Include fully-resolved prompt text and all refs\npanelgen plan --config panelgen.yml --show-prompt --show-refs\n```\n\n### List scenes\n\n```bash\npanelgen scenes\npanelgen scenes -config comic.yml\n```\n\n### Starter example files\n\n```bash\n# Copy starter config and style guide\ncp examples/panelgen.yml ./panelgen.yml\ncp examples/style.txt ./style.txt\n\n# Advanced flow examples (panel-to-panel continuity, panel-specific refs)\ncp examples/panelgen-advanced.yml ./panelgen-advanced.yml\n\n# Optional: add your reference images\nmkdir -p refs\n# cp /path/to/your/reference.png refs/clockwork-fox.png\n\n# Generate panels\npanelgen batch --config panelgen.yml\n```\n\n`examples/panelgen-advanced.yml` demonstrates:\n- using one panel output as a ref for a later panel to preserve continuity\n- adding a panel-specific character via panel-level refs without changing scene defaults\n\n## Config format\n\n```yaml\nstyle: style.txt          # Style guide prepended to every prompt\n\ndefaults:\n  size: 1024x1024\n  quality: low\n\noutput_dir: generated/\n\ncharacters:\n  explorer:\n    description: \"Clockwork fox explorer — white space suit, glass helmet\"\n    refs:\n      - characters/clockwork-fox.png\n\nscenes:\n  space-solo:\n    description: \"Single character floating in space\"\n    prompt_prefix: \u003e\n      Comic panel in outer space with purple/blue starry background.\n      Square panel with rounded corners.\n    characters:\n      - explorer\n    size: 1024x1024\n\npanels:\n  - page: 1\n    scene: space-solo\n    prompt: \u003e\n      Character floating near a terminal. Speech bubble: \"Nice. The app is up.\"\n\n  - page: 2\n    scene: space-solo\n    prompt: \u003e\n      Character looking shocked at an exploding pod.\n```\n\n### Output versioning\n\nEach panel is saved as `page_{N}_{quality}-{version}.png` (e.g. `page_3_low-1.png`).\nRe-running skips panels that already have a version at the requested quality.\nUse `-force` to generate a new increment without deleting existing versions.\n\n### Agentic use\n\nBecause `panelgen` is a static binary with no runtime dependencies, it drops into\nany agentic pipeline as a shell tool:\n\n```bash\n# Generate a prompt with an LLM, pass it to panelgen\nllm \"Write a comic panel prompt for page 5\" \u003e prompt.txt\npanelgen generate -prompt-file prompt.txt -scene space-conversation output.png\n```\n\nOr via container in a CI/agentic step:\n\n```bash\ndocker run --rm \\\n  -v \"$PWD:/work\" \\\n  -e AZURE_OPENAI_ENDPOINT \\\n  -e AZURE_OPENAI_API_KEY \\\n  panelgen generate -prompt-file /work/prompt.txt /work/output.png\n```\n\n## Building\n\n```bash\nmake build        # current platform\nmake build-all    # Linux amd64/arm64, macOS amd64/arm64, Windows amd64\nmake docker       # container image\n```\n\n## Release\n\nReleases are automated with GoReleaser.\n\n```bash\nmake release-check     # validate .goreleaser.yml\nmake release-snapshot  # local artifacts in dist/ (no GitHub publish)\n```\n\nPush a version tag to publish a GitHub release via Actions:\n\n```bash\ngit tag v0.1.0\ngit push origin v0.1.0\n```\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphink%2Fpanelgen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraphink%2Fpanelgen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphink%2Fpanelgen/lists"}