VIBEPACKR · PRIVATE PoC
Your VM. Your workflow. Start your PoC.
Download the approved package, install it in your environment, connect your business systems and complete a Work through its results and audit report. Your team and its AI can follow this page independently.
Use the Google account approved for your organization. The package requires active download and private PoC access. If access is pending or expired, the portal displays that state; your organization's contact arranges access before installation.
What VibePackr provides
The approved package, installation media and English/Korean instructions. The package includes a complete appliance archive for installation into your VM. A clean disk image is optional import media for your own platform.
What your team prepares
Your own Debian 13 amd64/x86_64 VM with systemd, approved installation privileges, storage and network access. Your team selects and operates the VM, AI runtime and business-system credentials.
Your infrastructure, without a marketplace dependency
The PoC package installs on your own compatible VM in AWS, Azure, GCP or on-premises; no cloud marketplace listing or subscription is required. The current server target is Debian 13 amd64/x86_64 with systemd. Your team provides the required installation privileges, storage and network access. Google sign-in to the download portal does not require GCP hosting. This describes the deployment model, not a qualification of every cloud configuration.
| Environment | Current delivery status | What to do |
|---|---|---|
| Debian 13 · amd64/x86_64 · systemd | Supported installer target; installation checked in a local VM. | Use a compatible customer VM with approved privileges, storage and network. |
| AWS · Azure · GCP · on-premises | Customer-chosen hosting; no marketplace dependency. Not a qualification of every cloud configuration. | Provision the supported guest OS/CPU and follow your platform’s VM procedure. |
| Ubuntu 22.04/24.04 · RHEL · Rocky Linux | Not qualified for this installer. | Use a supported Debian VM, or obtain an explicitly supported delivery for your OS. |
| ARM64 server · Docker/containers | No matching server delivery or container quickstart is provided by this guide. | A macOS ARM64 CALF client is separate from the x86_64 server requirement. |
This is the server environment table. Clients and connected AI runtimes have their own requirements. The complete appliance can be installed without an external AI provider; later business workflows may require separately approved connections.
Before installation: inspect this VM
uname -s
uname -m
cat /etc/os-release
ps -p 1 -o comm=
df -hConfirm Linux, x86_64, Debian 13 and systemd as PID 1. Storage sizing depends on the chosen workflow and retained evidence; this page does not prescribe an unmeasured minimum.
FROM DOWNLOAD TO A COMPLETED WORK
Follow one continuous path
DOWNLOAD
Get the approved delivery
Sign in, select the PoC package and compare its file identity and SHA-256 with the approved delivery. Keep the complete package together.
Open approved downloads →Continue when: your account is allowed and the downloaded bytes match.
INSTALL
Install on your VM
Extract the complete appliance archive on your supported VM, then follow install.md and run the included install.sh from its root. If you chose the optional VM media bundle, use installer-media/vibepackr-appliance.tar.gz inside it.
Read the AI installation guide →Continue when: the actual installation result and installed paths are recorded. Resolve any failed health prerequisite using the local bootstrap.
CONNECT
Bind your working environment
Use /opt/vibepackr/setup paths to find the installed BOOTSTRAP.md and Skills. Connect your actual client, AI runtime and customer identity, then use GAPE and Integration Helper for your business systems.
Setup and binding manual →Continue when: actual loading, connection and native binding responses are confirmed for this installation.
RUN
Complete your first real Work
Choose one business task and its permitted inputs and effects. Follow the supported declaration and execution path, retain the returned Work ID and handle customer-side confirmations at their exact checkpoints.
PackrGUI and headless workflow →Continue when: the execution state and effects for that same Work are available.
REVIEW
Read the results and audit report
Inspect the output, evidence references and audit report associated with the original Work. Record actual success, partial completion or failure and the customer's acceptance separately.
Result and report inspection →Complete when: the customer can trace the result and report to the same Work and assess its actual outcome.
OPERATE
Retain control of your environment
Your team manages access, evidence retention and recovery on its VM. Preserve the first failure and resume the same Work using supported instructions. Use the supplied authorized disable/removal procedure when needed.
Operations and recovery manual →Retain: the original Work ID, actual observations and customer-controlled records.
First exercise: create a local Work record
Use CREATE_AUDIT_ARTIFACT to learn the submission → execution → same-Work inspection path. The input is a short intent plus one unused idempotency key. No customer dataset or model subscription is needed for this local operation.
Scope: it creates a structured local lineage artifact. It does not analyze an attached document, query your database or demonstrate an AI model call. Run it only when your supplied release lists the operation and your customer administrator has authorized this one Work.
1. Check the installed interface
On the Debian appliance, use your existing authorized root administration session for the following runuser commands. If that route is unavailable, use the installation’s documented operator route; do not change socket permissions or grant new privileges.
CTL=/opt/vibepackr/current/bin/packrctl
SOCKET=/run/vibepackr/control-plane.sock
"$CTL" --help
runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" status --json
runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" health --jsonRead the actual status and reason fields. Service liveness is not Work authority. Resolve a refusal, missing binding or unmet prerequisite using the installed bootstrap before submitting.
2. Submit once and retain the response
Set WORK_DIR to an existing customer-approved private directory and POC_KEY to one approved unused key for this exercise. Keep the same shell variables for the following blocks. Submission creates a Work record; the website’s Copy button never executes it.
# Set your actual WORK_DIR and approved unused POC_KEY first.
(
: "${WORK_DIR:?Set the approved existing private directory}"
: "${POC_KEY:?Set one approved unused key}"
: "${CTL:?Run the interface block first}"
: "${SOCKET:?Run the interface block first}"
test -d "$WORK_DIR" || exit 66
umask 077
RUN_DIR=$(mktemp -d "$WORK_DIR/first-work.XXXXXX") || exit 73
printf '%s\n' "$RUN_DIR"
printf '%s\n' "$POC_KEY" > "$RUN_DIR/request-key.txt"
set +e
runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" \
--timeout-seconds 30 work run CREATE_AUDIT_ARTIFACT \
"Create a local audit artifact for this PoC" "$POC_KEY" --json \
> "$RUN_DIR/work-run.json" 2> "$RUN_DIR/work-run.stderr"
work_exit=$?
printf '%s\n' "$work_exit" > "$RUN_DIR/work-run.exit"
exit "$work_exit"
)Read work-run.json and work-run.exit in the printed directory. Copy the actual result.work.work_id into WORK_ID. A timeout, empty result or exit 0 is not a completion receipt. Do not rerun this block to recover an uncertain submission.
3. Inspect the same Work and its evidence
# Set WORK_ID to the exact result.work.work_id returned above.
(
: "${WORK_ID:?Set the actual returned Work ID}"
: "${CTL:?Run the interface block first}"
: "${SOCKET:?Run the interface block first}"
runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" \
work show "$WORK_ID" --json
)| Inspect | Expected observation / interpretation |
|---|---|
| Identity | The returned Work ID remains the same across run, show and the product report. |
| Output and validation | Inspect the local artifact and actual validation result; record its evidence and receipt references. A JSON file alone is not proof. |
| Human acceptance | The retained local test reached AWAITING_HUMAN_ACCEPTANCE and AUTOMATION_COMPLETED_HUMAN_ACCEPTANCE_PENDING. Treat these as waiting for acceptance, not final acceptance. |
| Missing or failed result | Keep the original key, Work ID if returned, and first error. Query/reconcile before another attempt; do not delete the journal or invent a receipt. |
Evidence scope: this walkthrough uses the supplied public CLI and a retained local Debian PoC execution from 6 November 2026. That execution is separate from the newer installer-only check. It is not a new run in your VM, a business-data test, a cloud-wide certification or a timed five-minute guarantee.
Full first-Work and report procedure →Network and data boundaries
Separate the download path, VM-local control path and optional business connections. The diagram describes the supplied installation model; use the actual configuration and listener observations to review your deployment.
Customer browser / administrator
Approved Google account → download portal → verified complete package
↓ HTTPS download, then approved transfer or offline media
Customer-owned Debian VM
packrctl / configured local adapter → Unix socket → control plane
/run/vibepackr/control-plane.sock
Local Work, artifacts and evidence remain in the configured customer storage.
Remote product-client access uses the explicitly configured product gateway. Customer-authorized OS administration is a separate route.
↕ Optional connections defined by the chosen runtime / adapter
Customer systems / chosen AI provider
Review endpoint, protocol, payload, credentials and retention for each connection.
| Path | Transport / port | Required when |
|---|---|---|
| Browser → download/authentication | HTTPS / 443 for the published HTTPS services. | Obtaining the package online. The VM can receive approved offline media. |
| Local control plane | Unix socket /run/vibepackr/control-plane.sock; not a TCP port. | The supplied local headless route. Socket ownership remains unchanged. |
| Local MCP host → native server | stdio between the MCP host and its local child process; no listening TCP port for that transport. An adapter’s onward VM connection is separate. | When the customer chooses the Local MCP connection. |
| Remote product client / product administrator | Actual address/port from the configured gateway and customer network. No universal port is prescribed here. | Only when remote access is configured and authorized. |
| AI runtime / business connector | The selected endpoint’s configured protocol and port; may stay internal or use an external service. | When required by the chosen business workflow; not by appliance installation alone. |
Self-hosting does not itself prohibit outbound traffic. Local Sources attachment controls supplied context, not every file permission of a connected agent. Review runtime permissions and network controls separately. Do not open a firewall or expose a service merely to make a health check pass.
Keep these checks at hand
These commands read status and bounded logs. Use the customer-approved operator session; journal and socket inspection may require existing administrator access. Keep raw outputs in the customer’s private records.
/opt/vibepackr/setup paths
systemctl status vibepackr-control-plane.service --no-pager --full
journalctl -u vibepackr-first-boot.service -u vibepackr-control-plane.service -n 100 --no-pager
/opt/vibepackr/healthsetup paths identifies the installed bootstrap and Skills. The installer log is install.log, with install.exit beside it, in the private directory printed by install.md. Runtime service output is inspected through journald; no fixed /var/log/vibepackr.log is assumed. Read the actual health exit and missing prerequisite.
Inspect listeners and optional gateways
ss -lntup
ss -lx
systemctl status vibepackr-customer-access-gateway.service --no-pager
systemctl status vibepackr-remote-admin-gateway.service --no-pagerOptional gateway units depend on their installation configuration. An inactive unconfigured gateway is not automatically a product failure. Reconcile observed ports with the customer’s actual gateway configuration; do not paste credentials or full configuration files into a support ticket.
| Observation | Next action |
|---|---|
| Installer exit 77 / sudo denied | Have the customer administrator provide the approved installation route. |
| Installer exit 65 | Read the first installer error: integrity, path or release conflicts can use this exit. Preserve existing installation identity. |
| Service active, health nonzero | Inspect missing bootstrap/customer-binding conditions. Do not equate liveness with business readiness. |
| Submission timeout / missing response | Keep the request key and any returned Work ID. Query/reconcile the original submission before retrying. |
| Same release already installed | Continue configuration through setup. For a different release, use its supported upgrade/recovery instructions. |
Resume, disable or retire without erasing history
Resume the original Work using its supported inspection/reconciliation path. /opt/vibepackr/diagnostics, /opt/vibepackr/disable and /opt/vibepackr/uninstall are native administrative entry points that require the installation’s state root, request and credential files. They are not generic restart, rollback or cleanup commands. Use the installed administrator procedure and verify the result; do not delete /var/lib/vibepackr or repoint current by hand.
Operations, recovery and removal procedure →Hand this to your AI
Read https://www.vibepackr.com/install.md. Identify the approved complete package and our target VM. Within our existing authorization, verify it, install with the supplied install.sh, then follow the installed bootstrap to bind our environment. Record real results and missing prerequisites. Continue to business Work only within our approved task scope.
install.md provides AI instructions; install.sh is the shared human/AI installer. English and Korean describe one procedure, so run each step once.
Copy only places these instructions on your clipboard. It does not install software, submit Work or change permissions.
Connect the workbench your team already uses
The PoC walks your team through installation, a first Work, and its results and audit report. To bring that process into everyday use, the next step is connecting requests, execution state and evidence to the workbench your team already uses. This lets your team assess how VibePackr fits its existing workflow.
The Customer Workbench Integration guide uses CALF (Controlled Agent Lifecycle Framework), a lightweight local AI harness with a Rust core and a Tauri workbench. CALF connects work scope, permission boundaries, execution, verification, recovery and retained records through CLI, SDK and MCP. Follow the CALF reference for Local MCP and Adapter connections, or use the SDK binding from your own application. CALF is optional; each system keeps its own authorization, records and validation responsibilities.
Current CALF reference: Harness 1.8.13 · Workbench 1.9.9 · SDK 0.2.6, published 11 November 2026. Use the shared local records with or without the Workbench UI. The guide covers current controls, scoped context and governed MCP calls while keeping client compatibility and native VibePackr qualification separate.
Start after the common PoC setup and the native connection handoff are ready. The example validates a captured integration-analysis report; actual business Work completion still requires the product’s own validation and receipt.
Customer Workbench Integration with CALF → AI setup for CALF · install.md →