Skip to main content

​
Getting Started

Goal: go from zero to a first working chat with minimal setup.
If you plan to use wallet, mining, Fased Network, Marketplace, or other wallet-connected features, read the repo risk boundary before moving funds or enabling public participation: docs/legal/disclaimer.md.
Fastest chat: open the Control UI (no channel setup needed). Run fased dashboard and chat in the browser, or open http://localhost:18789/ on the . Docs: Dashboard and Control UI.

​
Prereqs

  • Node 24 recommended, or Node 22.14+ with the built-in node:sqlite module
Check your runtime with node --version and node -e 'require("node:sqlite"); console.log("node:sqlite ok")' if you are unsure.

​
Which install do I need?

This computer

Choose Local. Best for a laptop, desktop, dev box, WSL2, or first chat.

VPS / always-on server

Choose Hosting. Create/sign into Tailscale first, then run the hosted installer on the VPS.

macOS app

Use the app-first flow, then finish models, skills, channels, and tasks in the Control UI.
For the full decision table, read Setup Matrix.

​
Quick setup (CLI)

1

Install Fased (recommended)

git clone https://github.com/fased-ai/fased.git fased
cd fased
./install.sh
Use this for your laptop, desktop, dev box, or WSL2.
Other install methods and requirements: Install.
2

Run or continue onboarding

fased onboard --install-daemon
./install.sh runs onboarding by default. Run this command only if you skipped onboarding, got interrupted, or want to reconfigure the daemon.The wizard configures workspace, Gateway, dashboard access, and optional wallet/mining setup. If you are setting up a VPS, use the Hosting install path above; a normal local fased onboard session cannot safely apply VPS SSH/firewall hardening.See Onboarding Wizard for details.
3

Check the Gateway

If you installed the service, it should already be running:
fased gateway status
4

Open the Control UI

fased dashboard
The dashboard command opens an auth-ready local link such as http://localhost:18789/#token=.... The browser exchanges that fragment for a Control UI session and strips it from the address bar. If the browser asks for a token later, use the Gateway recovery token printed by onboarding.Continue setup in the browser from Agents:
  • Agent > Models: add a provider API key or sign in, then choose the Agent’s primary and fallback models.
  • Agent > Skills: create, review, install, configure, edit, and allow skills for that Agent.
  • Agent > Services: connect Gmail, Calendar, GitHub, web/search, browser/media, or custom APIs.
  • Agent > Channels: connect chat apps and route them to the Agent.
  • Agent > Memory: enable session-memory and review this Agent’s archive/QMD state.
  • Agent > Tasks: schedule recurring work for this Agent when needed.
See Control UI Setup Model for what belongs in onboarding, the browser UI, Advanced Config, and CLI.
5

Send the first browser chat

After Agent > Models shows a ready provider/model for the selected Agent, open Chat, choose the same Agent, and send a small test:
Reply with one sentence: Fased is ready.
If it fails, fix the first visible blocker in this order:
  1. Agent > Models: provider auth or model selection
  2. Logs: provider/runtime error detail
  3. Advanced > Debug: raw diagnostics and repair tools
If the Control UI loads, your Gateway is ready for use.

​
Choose your next path

Once the dashboard is up, pick the path that matches your goal:

Fased Agent first

Use Fased as your self-hosted Agent runtime with sessions, tools, and channels.

Wallet + Fased Network

Continue into wallet policy, hosted reachability, trusted network participation, and bond operator setup.

SAT operator path

Create or import @wallet:mining, fund capital, and run the SAT mining workflow.

​
Optional checks and extras

Useful for quick tests or troubleshooting.
fased gateway --port 18789
Requires a configured channel.
fased message send --target +15555550123 --message "Hello from Fased"

​
Useful environment variables

If you run Fased as a service account or want custom config/state locations:
  • FASED_HOME sets the home directory used for internal path resolution.
  • FASED_STATE_DIR overrides the state directory.
  • FASED_CONFIG_PATH overrides the config file path.
Full environment variable reference: Environment vars.

​
Go deeper

Onboarding Wizard (details)

Full CLI wizard reference and advanced options.

macOS app onboarding

First run flow for the macOS app.

​
What you will have

  • A running Gateway
  • A workspace and runtime identity
  • Gateway token auth configured, with an auth-ready dashboard link for local setup
  • A browser setup path for Agent model/provider auth
  • Control UI access or a connected channel

​
Next steps