Sets up AskAlf — an AI workforce that thinks, heals, remembers, and evolves with a nervous system, immune system, collective memory, dream cycles, and natural selection. Runs in a single Node.js process.

Quick Start

npx create-askalf

Interactive setup:

Connect Claude account (OAuth — uses your subscription) or enter an API key
Downloads and builds the platform
Seeds 50 agent templates + 3 default fleet agents
Launches the full dashboard at http://localhost:3000

Quick Mode

npx create-askalf --quick

Skips prompts. Auto-detects Claude OAuth if logged in, falls back to ANTHROPIC_API_KEY env var.

Doctor

npx create-askalf doctor

Built-in diagnostic and repair tool. Auto-detects your install type (Docker or standalone), checks prerequisites, verifies config, fixes broken secrets, and offers AI-powered troubleshooting via Claude Code.

Checks: git, node, pnpm, .env, dependencies, build, ports, Docker status
Auto-fixes: missing pnpm, broken secrets, missing infrastructure configs
If Claude Code is installed, Alf will fix remaining issues for you

What You Get

Full dashboard UI at http://localhost:3000 — fleet view, organism tab, settings, terminal
PGlite database — in-process PostgreSQL via WASM, no external DB needed
In-memory cache — no Redis needed
50 agent templates across 10 categories (dev, marketing, support, research, etc.)
3 default agents — Watchdog, Builder, Fleet Chief
Real AI chat — talk to Alf, design agent teams in natural language
Universal AI — works with Claude OAuth, Anthropic API, OpenAI, or Ollama (any one)

AI Providers

Works with whatever you have. Priority chain:

Priority	Provider	Config
1	Claude OAuth	`claude login` (uses subscription)
2	Anthropic API	`ANTHROPIC_API_KEY`
3	OpenAI API	`OPENAI_API_KEY`
4	Ollama local	`OLLAMA_URL` (default localhost:11434)

No provider is required at install time — configure any one later in ~/.askalf/.env.

Migrate to Docker

Outgrew standalone? One command:

bash scripts/migrate-to-docker.sh

Exports PGlite data, generates Docker .env, imports into PostgreSQL. Your standalone data stays untouched.

Production (Docker)

curl -fsSL https://get.askalf.org | bash

Full stack: PostgreSQL + pgvector, Redis, Ollama, SearxNG, headless Chromium. 6 containers at localhost:3001 in 60 seconds.

Links

MIT — askalf.org

Keywords

FAQs

What is create-askalf?

Is create-askalf well maintained?

Package last updated on 07 Apr 2026

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

create-askalf