create-askalf
v3.1.4
Published
Create an AI workforce that thinks, heals, remembers, and evolves. One command. No Docker.
Maintainers
Readme
create-askalf
One command. Full AI workforce. No Docker.
npx create-askalfSets 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-askalfInteractive 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 --quickSkips prompts. Auto-detects Claude OAuth if logged in, falls back to ANTHROPIC_API_KEY env var.
Doctor
npx create-askalf doctorBuilt-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.shExports PGlite data, generates Docker .env, imports into PostgreSQL. Your standalone data stays untouched.
Production (Docker)
curl -fsSL https://get.askalf.org | bashFull stack: PostgreSQL + pgvector, Redis, Ollama, SearxNG, headless Chromium. 6 containers at localhost:3001 in 60 seconds.
Links
MIT — askalf.org
