Metadata-Version: 2.5
Name: pacxio
Version: 0.0.4
Summary: Packaging prepress for coding agents: dielines, 3D, print-ready factory files
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: ezdxf>=1.3
Requires-Dist: fonttools>=4.50
Requires-Dist: numpy>=1.26
Requires-Dist: packaging>=24
Requires-Dist: pikepdf>=9.0
Requires-Dist: pillow>=10.0
Requires-Dist: pydantic>=2.6
Requires-Dist: pyyaml>=6.0
Requires-Dist: reportlab>=4.0
Requires-Dist: shapely>=2.1
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# pacxio

**Packaging, from a prompt.**

Describe your packaging in Claude Code or Codex. Build editable dielines, turn and fold them in 3D, and review the design in a local workbench. Use the pacxio cloud service for artwork composition, preflight and factory delivery files.

[Website](https://pacxio.dev/) · [Install](https://pacxio.dev/install) · [Docs](https://pacxio.dev/docs.html) · [Structure library](https://pacxio.dev/structures.html) · [Online generator](https://pacxio.dev/generator.html) · [Examples](https://pacxio.dev/examples.html) · [PyPI](https://pypi.org/project/pacxio/)

## See it in action

A 51-second walkthrough: a brief in your coding agent, design choices, the dieline approval and the packaging workbench.

https://github.com/user-attachments/assets/a0312f38-b2d6-444b-a0ae-4d56e6c51edf

[Watch on pacxio.dev](https://pacxio.dev/#demo)

## Made with pacxio

### pacxio Dieline Tee

**FEFCO 0427 mailer · 280 × 210 × 60 mm**

A mailer for pacxio's own T-shirt: a blue-to-coral gradient, a silver-foil mark, and a design carried across the back and base. The concept sets the direction; the artwork is rebuilt on the dieline and previewed on the folded structure.

| Concept | Folded 3D preview |
|---|---|
| ![pacxio Dieline Tee concept](https://pacxio.dev/assets/gallery/tee-concept.webp) | ![pacxio Dieline Tee folded 3D preview](https://pacxio.dev/assets/gallery/tee-front.webp) |

| Open view | Dieline proof |
|---|---|
| ![Open FEFCO 0427 mailer showing the inside and closure](https://pacxio.dev/assets/gallery/tee-open.webp) | ![pacxio Dieline Tee artwork on its dieline](https://pacxio.dev/assets/gallery/tee-dieline.webp?v=3) |

[See the full gallery, including concepts, 3D views and dieline proofs →](https://pacxio.dev/examples.html)

## Install

Paste this into **Claude Code or Codex**:

```text
Read pacxio.dev/install to install pacxio
```

Or install from your terminal with [uv](https://docs.astral.sh/uv/):

```bash
uv tool install pacxio
pacxio setup --agent claude-code --yes
```

For Codex, run `pacxio setup --agent codex --yes` instead. Setup installs the workflow Skill and MCP tools, and downloads the open-source Source Han Sans fonts if they are missing. Restart your agent after setup.

The plugin reads its full workflow and reference guides from the running MCP server, keeping the instructions and tools on the same version.

Then try a brief:

```text
Make a T-shirt mailer, 280 × 210 × 60 mm.
Show me the dieline and folding 3D before we work on the artwork.
```

[Full installation guide →](https://pacxio.dev/install)

### Updates

Automatic updates apply only to a standard, unpinned `uv tool install pacxio` from PyPI. pip, pinned versions, editable/source installs and custom-source installations remain manual. Eligible installations check in the background when MCP starts. A verified update is used on a later startup; your current session keeps its version. If a check or download fails, the working version remains available. Set `PACXIO_AUTO_UPDATE=0` to turn automatic updates off.

Check the running and prepared versions locally with `pacxio update status --json`, or ask your agent to call `pacxio_update_status`. These diagnostics do not start an update.

The global `pacxio` command also uses the verified runtime. `uv tool list` shows the installed bootstrap package, which can differ from the version actually running. During a design session, your agent uses the connected MCP server's tools and guides together.

If you installed pacxio before this update mechanism, migrate once:

```bash
uv tool upgrade pacxio
pacxio setup --yes
```

Restart your agent afterward. Setup updates every supported agent found on your machine; add `--agent codex` or `--agent claude-code` to target one. To replace a running Workbench, run `pacxio studio stop <job>` and then `pacxio studio start <job> --open`. Your job files and saved choices stay in the job folder.

If MCP is unavailable, automatic updates through the plugin are unavailable too. You can still use the installed CLI manually with its matching workflow; the plugin's `SKILL.local.md` is a snapshot from installation.

## Open-source core and cloud service

| On your machine · this repository · MIT | On the pacxio cloud service · sign-in required |
|---|---|
| FEFCO and public ECMA structures, plus carton, mailer, label and pouch entries | Artwork composition and vector reconstruction |
| Editable geometry and dieline export: DXF, CF2 and PDF | CMYK print PDF and named spot-color plates for foil, spot UV and embossing |
| Folding 3D preview and the local workbench | Print preflight, specification sheet and factory delivery pack |
| Job records, content lists, concepts and review notes | |

The client routes cloud commands automatically. Run `pacxio login` to connect your account. Cloud commands send the required job files to the service and return previews, reports and delivery files to your local job folder.

[How the open-source core and cloud service work →](https://pacxio.dev/docs.html#open) · [Privacy](https://pacxio.dev/privacy.html)

## Command line

Preview a structure without creating a job:

```bash
pacxio structures preview 0427 --L 280 --W 210 --H 60 --out preview/
```

Or start a project and open its workbench:

```bash
pacxio job init jobs/demo --fefco 0427 --L 280 --W 210 --H 60 --material flute_e
pacxio studio start jobs/demo --open
pacxio next jobs/demo
```

Use `pacxio structures suggest --use ecommerce --no-tape --material corrugated --json` to find structures for a brief.

Commands accept `--json` and return `{ok, command, job, artifacts, data, errors, warnings}`. Errors include a suggested fix. Messages default to English; set `PACXIO_LANG=zh` for Chinese.

[Browse the command guide →](https://pacxio.dev/docs.html)

## Production checks

- **Print text is typeset by the engine and outlined.** AI-generated print images must not contain text.
- **Concepts guide the design.** Final artwork is rebuilt from confirmed flats before it goes on the dieline.
- **You approve the proof.** Dieline approval is a user step; your agent must leave it to you.
- **Preflight errors block export.** Fix them before generating factory files.
- **Dielines use lines and arcs.** DXF R12 and CF2 do not contain Bézier curves.
- **Cut and crease lines use named spot colors and overprint.** They are never drawn in Registration.
- **Check each structure's verification status.** Values marked as initial need confirmation, and uncalibrated structures need a physical proof before production.

## Development

```bash
uv sync
uv run pytest
uv run ruff check .
uv run mypy
uv run pacxio env check
```

Tests that need the closed-source package are skipped in an open-source-only installation. Fonts and ICC profiles are not bundled in this repository.

## License and contact

The code in this repository is licensed under [MIT](LICENSE). Cloud features are provided as a separate service.

[Website](https://pacxio.dev/) · [Documentation](https://pacxio.dev/docs.html) · [Terms](https://pacxio.dev/terms.html) · [support@pacxio.dev](mailto:support@pacxio.dev)
