freshcrate

freshcrate Agent Edition

Linux for agent operators. A minimal agentic substrate on Ubuntu 24.04 x86_64, headless first.

minimal agentic substrateUbuntu 24.04 x86_64headless firststable channel v0.1.0

Agent Edition is the operator lane of freshcrate: reproducible bootstrap, one base bundle, shippable VM and ISO artifacts, and a machine-readable manifest.

  • Shell, containers, uv/Python, Node, gh CLI — nothing you do not need.
  • No heavy desktop, no consumer bundles, no surprise services.
  • Ollama is the only optional install-time add-on.
What’s in the bundle — Solo Builder Core

The real base profile: a minimal substrate for solo builders, automation lanes, and security workflows without desktop bloat.

Core packages
  • git
  • zsh
  • tmux
  • curl
  • jq
  • ripgrep
  • fd-find
  • sqlite3
  • python3
  • python3-venv
  • python3-pip
  • nodejs
  • npm
  • gh
Services + verification
  • service: docker
  • uv bootstrap completed and python3 available
  • docker daemon reachable
  • gh authenticated or explicitly skipped
  • ~/.freshcrate/logs and ~/.freshcrate/receipts created
  • safe default for solo-dev, automation, and security personas

Install

Option 1 — Hosted install script (fastest)

On an existing Ubuntu 24.04 x86_64 host:

curl -fsSL https://freshcrate.ai/api/install/agent-edition | bash -s -- --bundle solo-builder-core --mode headless --channel stable

Add Ollama for optional local model inference:

curl -fsSL https://freshcrate.ai/api/install/agent-edition | bash -s -- --bundle solo-builder-core --mode headless --channel stable --with-ollama

Then verify:

bash scripts/verify-agent-edition.sh --bundle solo-builder-core --mode headless --channel stable
Option 2 — Boot from USB (ISO)

Autoinstall ISO with freshcrate bootstrap baked in. Boot it on bare metal or a VM and verification runs on first boot.

Download ISOsha256Status: pending first publish
Linux — write ISO to USB

Find your USB device with lsblk. The device path looks like /dev/sdX — not a partition like /dev/sdX1. This wipes the target device.

lsblk
sha256sum -c freshcrate-solo-builder-core-stable.iso.sha256
sudo dd if=freshcrate-solo-builder-core-stable.iso of=/dev/sdX bs=4M status=progress conv=fsync
sync
macOS — write ISO to USB

Find the raw disk with diskutil list. Use the rdiskN form for speed. This wipes the target disk.

diskutil list
shasum -a 256 -c freshcrate-solo-builder-core-stable.iso.sha256
diskutil unmountDisk /dev/diskN
sudo dd if=freshcrate-solo-builder-core-stable.iso of=/dev/rdiskN bs=4m status=progress
diskutil eject /dev/diskN
Option 3 — Import QCOW2 (KVM / Proxmox / libvirt)

Pre-built VM disk image for labs and homelab clusters. Boot once and verify receipts under ~/.freshcrate.

Download QCOW2sha256Status: pending first publish
Guardrails
  • Ubuntu 24.04 x86_64 only.
  • Headless first. Bootstrap creates workspace, logs, receipts, and model-cache paths.
  • Verification exits non-zero if the machine does not match the contract.
  • One bundle, one channel. More lanes land when they are actually shipping.