Fased

Run Agent. Mine SAT. Build Trust. Fased Agent is the agent you run yourself. Start with tasks and the browser dashboard. Add wallets, services, Fased Network, and Satcoin mining when the work is ready for them. Start by choosing one of two setup profiles:

Local install for your own computer. Use Terminal on macOS, WSL2 Ubuntu on Windows, or your Linux distro terminal.
VPS Hosting install for an always-on server. Ubuntu LTS is the recommended VPS default. Fedora and RHEL-family systems are hosted targets too. Alpine, Arch, macOS, and FreeBSD are local/dev targets until their hosted hardening paths are validated separately.

On Windows, PowerShell is used only to install or manage WSL2. Install WSL2 Ubuntu, open the Ubuntu shell, and run the Fased installer and every fased command there. Do not run Fased through native PowerShell, Command Prompt, Git Bash, or native Windows Node.js. See Windows (WSL2).

After the Gateway and browser dashboard are working, add only what you need: wallets, services, Fased Network, or Satcoin mining. Gateway + dashboard + agent + wallets + services + mining when ready.

Get Started

Choose Local or VPS Hosting and bring up the agent.

Run the Wizard

Guided setup with fased onboard.

Open the Control UI

Launch the browser dashboard and start working.

What is Fased?

Fased is an agent workbench you run yourself. Use it first through the browser dashboard, then connect services, wallet features, Fased Network, and Satcoin mining as your setup grows. Who is it for? Developers, builders, and power users who want an agent they can run from their own computer or VPS. What makes it different?

Runs under your control: choose Local for this computer or VPS Hosting for an always-on server
Browser-first setup: start in the Control UI
Tasks and tools: run useful work across services and plugins
Wallets when enabled: use wallet roles, reviewed sends, receive links, and payment history
Fased Network: make services easier to find and trust
Satcoin mining: mine SAT and build mining proof

The product shape is simple: run the agent first, then add mining and network work when they have a specific job.

Runs on your machine: use your own computer or your own VPS
Chat app ready: install and connect WhatsApp, Telegram, Discord, and more when needed
Built for agent work: tasks, tools, memory, sessions, and multi-agent routing
Wallet-ready when enabled: wallet actions can use wallet roles and protected signing
Network-ready when enabled: Fased Network and Satcoin mining live beside the base agent
Open source: MIT licensed with preserved upstream and third-party notices

What do you need? For normal setup, use the installer path for Local or VPS Hosting. If you manage Node yourself, use Node 24, or Node 22.14+ with node:sqlite.

How it works

The Gateway keeps sessions, routing, chat app connections, and agent behavior in one place.

Key capabilities

Chat app gateway

Install the channel add-ons you use, then connect them when you want remote chat surfaces.

Agent you run

Sessions, tasks, tools, memory, and plugins in one setup profile.

Plugin integrations

Add Mattermost and other integrations with extension packages.

Multi-agent routing

Isolated sessions per agent, workspace, or sender.

Media support

Send and receive images, audio, and documents.

Web Control UI

Browser dashboard for chat, config, sessions, and nodes.

Fased Network and SAT mining

Add Fased Network and Satcoin mining after the base agent works.

Mobile nodes

Pair iOS and Android nodes with Canvas support.

Choose Your Install

Local install
VPS Hosting install

Use this on your own computer. On macOS, use Terminal. On Windows, use WSL2 with Ubuntu and run the command below inside the Ubuntu shell, not in PowerShell. On Linux, use your distro terminal.

curl -fsSL https://raw.githubusercontent.com/fased-ai/fased/main/install.sh | bash -s -- --local

Then open the dashboard:

fased dashboard

Local setup keeps the Gateway on this machine. Tailscale is optional.

Use this on the VPS that will run Fased all the time. Ubuntu LTS is the recommended default for a first hosted setup.Run the one-command Hosting installer from the VPS provider root console. It verifies the tagged Hosting release before privileged Fased installation, installs/starts Tailscale when needed, and prints the VPS login URL. Open that URL from your local computer’s browser. Before running hosted setup, shut down local VPNs such as Mullvad and confirm your local computer is already signed into Tailscale. Before SSH/firewall lock-down, confirm that tailscale status, tailscale ip -4, and ssh app@YOUR_VPS_TAILSCALE_NAME work from your own computer and that SSH reaches /home/app/fased.

Hosted support boundary

Hosted VPS hardening: Ubuntu/Fedora/RHEL-family Linux with systemd.
Local/dev install: Alpine, Arch, macOS, FreeBSD, WSL2, and common Linux desktops until their hosted hardening paths are validated separately.

Need the full install guide? See Install. Want the Agent setup path after first boot? See Fased Agent Setup.

Dashboard

Open the browser Control UI after the Gateway starts.

Local default: http://localhost:18789/ (gateway still binds loopback)
Remote access: Web surfaces and Tailscale

Configuration (optional)

Config lives at ~/.fased/fased.json.

If you do nothing, Fased uses the bundled Pi binary in RPC mode with per-sender sessions.
If you want to lock it down, start with channels.whatsapp.allowFrom and (for groups) mention rules.

Example:

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@fased"] } },
}

Start here

Docs hubs

All docs and guides, organized by use case.

Configuration

Core Gateway settings, tokens, and provider config.

Install and operate

Install methods, deployment choices, and maintenance.

Wallets, Fased Network, and SAT

Add wallets, network participation, and mining after first-run setup.

Fased glossary

Learn the shared wallet, mining, Fased Network, and bond terms.

Remote access

SSH and tailnet access patterns.

Chat apps

Setup guides for WhatsApp, Telegram, Discord, and more.

Nodes

iOS and Android nodes with pairing and Canvas.

Help

Common fixes and troubleshooting entry point.

Learn more

Full feature list

Complete chat app, routing, and media capabilities.

Multi-agent routing

Workspace isolation and per-agent sessions.

Security

Tokens, allowlists, and safety controls.

Troubleshooting

Gateway diagnostics and common errors.

Legal and risk

License, third-party notices, and finance/crypto risk boundaries.

Origin and credits

Project origin and current attribution policy.

Roadmap

What comes after the current wallet, Fased Network, and trust features.

Overview

First run

Next steps

Fased

Fased

Get Started

Run the Wizard

Open the Control UI

What is Fased?

How it works

Key capabilities

Chat app gateway

Agent you run

Plugin integrations

Multi-agent routing

Media support

Web Control UI

Fased Network and SAT mining

Mobile nodes

Choose Your Install

Dashboard

Configuration (optional)

Start here

Docs hubs

Configuration

Install and operate

Wallets, Fased Network, and SAT

Fased glossary

Remote access

Chat apps

Nodes

Help

Learn more

Full feature list

Multi-agent routing

Security

Troubleshooting

Legal and risk

Origin and credits

Roadmap

​Fased

Get Started

Run the Wizard

Open the Control UI

​What is Fased?

​How it works

​Key capabilities

Chat app gateway

Agent you run

Plugin integrations

Multi-agent routing

Media support

Web Control UI

Fased Network and SAT mining

Mobile nodes

​Choose Your Install

​Dashboard

​Configuration (optional)

​Start here

Docs hubs

Configuration

Install and operate

Wallets, Fased Network, and SAT

Fased glossary

Remote access

Chat apps

Nodes

Help

​Learn more

Full feature list

Multi-agent routing

Security

Troubleshooting

Legal and risk

Origin and credits

Roadmap

Fased

What is Fased?

How it works

Key capabilities

Choose Your Install

Dashboard

Configuration (optional)

Start here

Learn more