Alternate Futures

What changed from af

This page explains what happened to the af command line tool and where each of its features went. Every old guide under /guides/ for af now redirects here.

af commands do not work in acc

The current CLI is acc. It deploys compute services (containers, templates, GPU and confidential workloads). The af sites, af storage, af functions, af ipns, af ens, af gateways, af agents, af observability, and af registry command groups do not exist in acc. If a tutorial tells you to run one of them, it is out of date.

Where each feature went

You usedNow
af sites (static sites on IPFS, Filecoin, or Arweave)Not in acc. Serve your build output from a container, for example an nginx image, with acc services create --kind docker. See Quick start.
af agents (Eliza and other agents)An agent service: follow Deploy an AI agent. Other AI workloads are templates: acc templates list --category AI_ML.
af functionsFunctions deploy from the web app Deploy page. The CLI's --kind function is not available yet.
af applicationsProjects and services. See Manage projects.
af api-keysPersonal access tokens: acc pat create. See Create and use access tokens.
af observabilityacc services logs, acc services info, and acc deployments.
af storage, af ipns, af ens, af gatewaysNot available. Container images come from any public OCI registry, for example GitHub Container Registry.
af registry (self-hosted registry prototype)Retired. The platform pulls from public registries.
af sites deploy in CI (GitHub Actions, GitLab, CircleCI, Jenkins)acc with AF_TOKEN and AF_PROJECT_ID set, and -y on commands that confirm. See Docs for AI agents.
Framework guides (Next.js, React, Astro) and migrations from other static hostsBuild the static output into a container image and deploy it as a service.

Custom domains

af attached domains to sites. Custom domains for Alternate Clouds services are not available yet. The old guide is archived at Custom domains (archived).

/guides/sites, /guides/functions, /guides/agents, /guides/storage, /guides/observability, /guides/applications, /guides/gateways, /guides/ipns, /guides/ens, /guides/cicd, /guides/best-practices, the deploy-* framework guides, and the migrate-from-* guides all redirect to this page. The retired pages remain in the site's git history.

Next steps

On this page