Self-host Paseo

Paseo README

How to install Paseo

PASEO_PASSWORD, PASEO_WEB_UI_ENABLED, PASEO_HOSTNAMES

docker run -d --name paseo \
  -p 6767:6767 \
  -e PASEO_PASSWORD=change-me \
  -v "$PWD/paseo-home:/home/paseo" \
  -v "$PWD:/workspace" \
  ghcr.io/getpaseo/paseo:latest

PASEO_PASSWORD, PASEO_HOSTNAMES

cp docker/docker-compose.example.yml docker-compose.yml
$EDITOR docker-compose.yml
docker compose up -d

PASEO_HOME, PASEO_PASSWORD, PASEO_LISTEN, PASEO_RELAY_ENABLED

npm install -g @getpaseo/cli
paseo

How to configure Paseo

• daemon.hostnamesAllowed hostnames for host-header validation (old daemon.allowedHosts is a deprecated alias)

  Allowed hostnames for host-header validation (old daemon.allowedHosts is a deprecated alias)

• daemon.listen=127.0.0.1:6767Config-file setting for the daemon listen address

  Config-file setting for the daemon listen address

• daemon.relay.enabledPersisted relay enablement; new homes write false

  Persisted relay enablement; new homes write false

  values: true|false

• features.webUi.enabledServe the browser web client from the daemon's HTTP server

  Serve the browser web client from the daemon's HTTP server

  values: true|false

• OPENAI_API_KEYOverride OpenAI provider key

  Override OpenAI provider key

• OPENAI_STT_API_KEYOpenAI speech-to-text endpoint key (dictation and voice mode STT)

  OpenAI speech-to-text endpoint key (dictation and voice mode STT)

• OPENAI_TTS_API_KEYOpenAI text-to-speech endpoint key (voice mode TTS)

  OpenAI text-to-speech endpoint key (voice mode TTS)

• PASEO_ALLOWED_HOSTSDeprecated alias for PASEO_HOSTNAMES

  Deprecated alias for PASEO_HOSTNAMES

• PASEO_DICTATION_LANGUAGEOverride dictation STT language

  Override dictation STT language

• PASEO_DICTATION_LOCAL_STT_MODELOverride local dictation STT model

  Override local dictation STT model

• PASEO_DICTATION_STT_PROVIDEROverride dictation STT provider selection (local or openai)

  Override dictation STT provider selection (local or openai)

• PASEO_HOME=~/.paseoSet the Paseo home directory (config and state)

  Set the Paseo home directory (config and state)

• PASEO_HOSTSet the daemon target for CLI commands

  Set the daemon target for CLI commands

• PASEO_HOSTNAMESOverride or extend daemon.hostnames for host-header validation

  Override or extend daemon.hostnames for host-header validation

• PASEO_LISTENOverride daemon.listen

  Override daemon.listen

• PASEO_LOCAL_MODELS_DIRControl local model directory

  Control local model directory

• PASEO_LOG_CONSOLE_LEVELOverride log.console.level

  Override log.console.level

• PASEO_LOG_FILE_LEVELOverride log.file.level

  Override log.file.level

• PASEO_LOG_FILE_PATHOverride log.file.path

  Override log.file.path

• PASEO_LOG_FILE_ROTATE_COUNTOverride log.file.rotate.maxFiles

  Override log.file.rotate.maxFiles

• PASEO_LOG_FILE_ROTATE_SIZEOverride log.file.rotate.maxSize

  Override log.file.rotate.maxSize

• PASEO_PASSWORDOn the daemon, the password to require (plaintext, hashed at startup); on the CLI, the password used to connect when the host URI has none

  On the daemon, the password to require (plaintext, hashed at startup); on the CLI, the password used to connect when the host URI has none

• PASEO_RELAY_ENABLEDEnable or disable the outbound relay for a daemon launch

  Enable or disable the outbound relay for a daemon launch

  values: true|false

• PASEO_TRUSTED_PROXIESConfigure trusted reverse proxy ranges for X-Forwarded-* headers

  Configure trusted reverse proxy ranges for X-Forwarded-* headers

• PASEO_VOICE_LANGUAGEOverride voice STT language

  Override voice STT language

• PASEO_VOICE_LLM_PROVIDEROverride voice LLM provider (claude, codex, opencode)

  Override voice LLM provider (claude, codex, opencode)

• PASEO_VOICE_LOCAL_STT_MODELOverride local voice STT model

  Override local voice STT model

• PASEO_VOICE_LOCAL_TTS_MODELOverride local voice TTS model

  Override local voice TTS model

• PASEO_VOICE_LOCAL_TTS_SPEAKER_IDOptional local voice TTS tuning

  Optional local voice TTS tuning

• PASEO_VOICE_LOCAL_TTS_SPEEDOptional local voice TTS tuning

  Optional local voice TTS tuning

• PASEO_VOICE_STT_PROVIDEROverride voice STT provider selection (local or openai)

  Override voice STT provider selection (local or openai)

• PASEO_VOICE_TTS_PROVIDEROverride voice TTS provider selection (local or openai)

  Override voice TTS provider selection (local or openai)

• PASEO_WEB_UI_DIST_DIROverride the daemon web UI build directory

  Override the daemon web UI build directory

• PASEO_WEB_UI_ENABLED=falseEnable or disable the daemon-served web UI

  Enable or disable the daemon-served web UI

  values: true|false

• passwordDaemon auth setting in config.json under daemon.auth: bcrypt hash that all HTTP and WebSocket clients must present (set via `paseo daemon set-password` or PASEO_PASSWORD)

  Daemon auth setting in config.json under daemon.auth: bcrypt hash that all HTTP and WebSocket clients must present (set via `paseo daemon set-password` or PASEO_PASSWORD)

• worktrees.root=$PASEO_HOME/worktreesWhere new git worktrees are created

  Where new git worktrees are created