Skip to content

Running X6

X6 runs on macOS with Python 3 and nothing else to install. It listens on 127.0.0.1 only.

  1. Start the server with a workspace folder. The workspace is the only folder X6’s file and command tools can use.

    Terminal window
    python3 x6-chat.py --workspace ~/x6-workspace
  2. Provide keys. On first start X6 asks for each key at a hidden prompt and offers to save it in the macOS Keychain. Only the model key is required; search keys are optional.

  3. Open the workspace at http://127.0.0.1:4190 and pair the browser (see Security model).

X6 looks for each key in this order and prints where it found it, never the key itself:

Set the model key, and optionally a search key (SEARCH_API_KEY: Brave, Tavily, or SerpApi), as environment variables before starting the server.

Nothing is written to a file.

Option What it does
--workspace DIR The one folder file and command tools may use. Leave it out to turn those tools off.
--search-provider brave|tavily|serpapi Only needed when the provider can’t be told from the key.
--port Another port (default 4190).
--data-dir Where chats and settings are stored.