Installation

Up and running in minutes.

Exact commands from the repository — nothing invented.

bash
curl -fsSL https://raw.githubusercontent.com/johsua092-ui/synapse-ai-agent/main/scripts/install.sh | bash

source ~/.bashrc    # or: source ~/.zshrc
synapse

Full walkthrough in the installation guide.

Quick start

Four steps to a working agent.

  1. 01

    Install

    Run the official installer for your platform. It handles Python 3.11, uv, Node.js, ripgrep, ffmpeg — everything.

    npx synapse-ai-agent
  2. 02

    Configure provider

    The setup wizard walks you through provider configuration. Bring your own key for OpenRouter, OpenAI, or a custom endpoint.

    synapse setup
  3. 03

    Start Synapse

    Launch the interactive TUI. Slash commands are available from the first prompt — try /help.

    synapse
  4. 04

    Give it a task

    Ask for real work. The agent searches memory, runs tools, and learns skills from what it does.

    > inspect my project and explain the architecture

Setup supports any configured provider — Synapse does not require one specific vendor.