DocsGetting StartedInstallation

Ryvos is a single Rust binary. No runtime dependencies, no Docker required.

Quick Install

Cargo (recommended)

cargo install ryvos

Binary Download

# Linux x86_64
curl -L https://github.com/ryvos/ryvos/releases/latest/download/ryvos-linux-x86_64 -o ryvos
chmod +x ryvos
sudo mv ryvos /usr/local/bin/

From Source

git clone https://github.com/ryvos/ryvos
cd ryvos
cargo install --path .

Verify

ryvos --version
# ryvos 0.6.5

First Run

ryvos init

This launches the interactive setup wizard. It will ask you to:

  1. Choose an LLM provider (Anthropic, OpenAI, Ollama, etc.)
  2. Set your API key
  3. Configure channels (Telegram, Discord, Slack, WhatsApp)
  4. Set up security preferences
  5. Configure heartbeat monitoring

Your config is saved to ~/.ryvos/config.toml.

Run as a Daemon

For always-on operation:

ryvos daemon --gateway

Or install as a systemd service:

# The init wizard offers to set this up for you
systemctl --user enable --now ryvos

This starts Ryvos with:

  • All configured channels (Telegram, Discord, etc.)
  • Web UI at http://localhost:18789
  • Viking memory server at http://localhost:1933 (if enabled)
  • Heartbeat monitoring
  • Cron scheduled tasks

Next Steps

Uninstall