Quickstart

1. Get an instance

Cloud
Self-host

On a Linux server with Docker and Node 18+:

git clone https://github.com/NousC/opennous.git && cd opennous
cp nous.env.example nous.env
# in nous.env, set APP_DOMAIN, API_DOMAIN, MCP_DOMAIN and OPENROUTER_API_KEY (or ANTHROPIC_API_KEY)
node scripts/selfhost-keys.mjs nous.env
docker compose --env-file nous.env up -d --build

The key script prints the owner’s setup link, https://app.yourdomain.com/signup?setup=<token>. Open it and create the first account. The full guide is Docker Compose.

2. Connect your agent

npx @opennous/cli@latest init

This signs you in, saves a key to ~/.nous/config.json and registers the MCP server with your agent. On self-host, add --url https://api.yourdomain.com. To configure an MCP host by hand, see the MCP server page.

3. Connect a source

Open Settings → Integrations and connect a CRM, mailbox, call recorder or outbound tool. Each provider has a setup page under Providers.

4. Ask for an account

Ask your agent about an account, or call the API:

curl -X POST https://api.opennous.cloud/v2/context \
  -H "Authorization: Bearer $NOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "focus": "acme.com" }'

How it works

Observations, entities and claims.

Cloud vs self-host

What differs between the two.

MCP server

Every tool your agent can call.

REST API

The same graph over HTTP.

To work on OpenNous itself, see Development environment.

Getting Started

Installation

Providers

1. Get an instance

2. Connect your agent

3. Connect a source

4. Ask for an account

Next

How it works

Cloud vs self-host

MCP server

REST API

​1. Get an instance

​2. Connect your agent

​3. Connect a source

​4. Ask for an account

​Next

How it works

Cloud vs self-host

MCP server

REST API

1. Get an instance

2. Connect your agent

3. Connect a source

4. Ask for an account

Next