Quickstart

Prerequisites

• Docker Desktop (Windows or macOS) or Docker Engine with Compose v2 (Linux)
• An API key for at least one supported provider (Anthropic, OpenAI, or a compatible gateway)

1. Install Tenure

Linux and macOS:

curl -fsSL https://raw.githubusercontent.com/tenurehq/tenure/main/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/tenurehq/tenure/main/scripts/install.ps1 | iex

If blocked by corporate policy:

irm https://raw.githubusercontent.com/tenurehq/tenure/main/scripts/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File install.ps1

The installer starts Tenure automatically. Your bearer token is printed at the end of installation and saved to ~/.tenure/token (Linux/macOS) or %USERPROFILE%\.tenure\token (Windows).

If you lose your token run:

Linux and macOS:

docker compose -f ~/.tenure/docker-compose.yml exec tenure node dist/index.js token

Windows (PowerShell):

docker compose -f "$env:USERPROFILE\.tenure\docker-compose.yml" exec tenure node dist/index.js token

And for the stopped container case:

Linux and macOS:

docker compose -f ~/.tenure/docker-compose.yml run --rm tenure node dist/index.js token

Windows (PowerShell):

docker compose -f "$env:USERPROFILE\.tenure\docker-compose.yml" run --rm tenure node dist/index.js token

2. Connect a provider

Open http://localhost:5757/onboarding in your browser. You will be prompted to:

1. Enter your provider credentials
2. Pick a default model
3. Answer a short questionnaire to seed your world model

Onboarding is optional. If you skip it, Tenure builds your world model from chat extraction over time.

3. Point your client

Set your client’s API base URL to http://localhost:5757/v1 and use your bearer token for authentication. The model list is populated from your configured providers.

For client-specific instructions, see clients.md.

4. Start chatting

Open http://localhost:5757/beliefs to watch your world model grow as you work.

---

Configuration

Environment variables

Variable	Description	Default
TENURE_PORT	Port the server listens on	5757
PORT	Fallback if TENURE_PORT is not set (for PaaS compatibility)	5757

To install on a different port:

Linux and macOS:

TENURE_PORT=5858 sh install.sh

Windows (PowerShell):

$env:TENURE_PORT=5858; powershell -ExecutionPolicy Bypass -File install.ps1

---

Managing Tenure

All commands reference the compose file written by the installer. Replace ~/.tenure with %USERPROFILE%\.tenure on Windows.

Check logs:

docker compose -f ~/.tenure/docker-compose.yml logs proxy

Stop:

docker compose -f ~/.tenure/docker-compose.yml down

Start:

docker compose -f ~/.tenure/docker-compose.yml up -d

Update to the latest image:

docker compose -f ~/.tenure/docker-compose.yml pull
docker compose -f ~/.tenure/docker-compose.yml up -d