Merge branch 'main' into docs-dify-cloud-first

n8n already led with Cloud signup — adds the explicit ✨ Recommended
banner to README and docs page Setup sections for visual consistency
with the other cloud-first integrations.

hindsight-docs/docs-integrations/agentcore.md

@@ -40,6 +40,10 @@ pip install hindsight-agentcore
 
 ## Quick Start
 
+:::tip Recommended: Hindsight Cloud
+[Sign up free](https://ui.hindsight.vectorize.io/signup) and grab an API key — no self-hosting required.
+:::
+
 ```python
 import os
 from hindsight_agentcore import HindsightRuntimeAdapter, TurnContext, configure

hindsight-docs/docs-integrations/agno.md

@@ -24,6 +24,10 @@ pip install hindsight-agno
 
 ## Quick Start
 
+:::tip Recommended: Hindsight Cloud
+[Sign up free](https://ui.hindsight.vectorize.io/signup) and grab an API key — no self-hosting required.
+:::
+
 ```python
 from agno.agent import Agent
 from agno.models.openai import OpenAIChat
@@ -33,7 +37,8 @@ agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
     tools=[HindsightTools(
         bank_id="user-123",
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
+        api_key="hsk_...",  # or set HINDSIGHT_API_KEY env var
     )],
 )
 
@@ -41,6 +46,10 @@ agent.print_response("Remember that I prefer dark mode")
 agent.print_response("What are my preferences?")
 ```
 
+### Self-hosting (local development)
+
+If you're running Hindsight locally with `./scripts/dev/start-api.sh`, swap the URL to `http://localhost:8888`. See the [installation guide](/developer/installation) for setup.
+
 The agent now has three tools it can call:
 
 - **`retain_memory`** — Store information to long-term memory
@@ -58,11 +67,11 @@ agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
     tools=[HindsightTools(
         bank_id="user-123",
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
     )],
     instructions=[memory_instructions(
         bank_id="user-123",
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
     )],
 )
 ```
@@ -74,7 +83,7 @@ Include only the tools you need:
 ```python
 tools = [HindsightTools(
     bank_id="user-123",
-    hindsight_api_url="http://localhost:8888",
+    hindsight_api_url="https://api.hindsight.vectorize.io",
     enable_retain=True,
     enable_recall=True,
     enable_reflect=False,  # Omit reflect
@@ -93,7 +102,7 @@ The bank ID is resolved in order:
 # Per-user banks from RunContext
 agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
-    tools=[HindsightTools(hindsight_api_url="http://localhost:8888")],
+    tools=[HindsightTools(hindsight_api_url="https://api.hindsight.vectorize.io")],
     user_id="user-123",  # Used as bank_id
 )
 
@@ -105,7 +114,7 @@ agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
     tools=[HindsightTools(
         bank_resolver=resolve_bank,
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
     )],
 )
 ```
@@ -118,7 +127,7 @@ Instead of passing connection details to every toolkit, configure once:
 from hindsight_agno import configure, HindsightTools
 
 configure(
-    hindsight_api_url="http://localhost:8888",
+    hindsight_api_url="https://api.hindsight.vectorize.io",
     api_key="your-api-key",       # Or set HINDSIGHT_API_KEY env var
     budget="mid",                  # Recall budget: low/mid/high
     max_tokens=4096,               # Max tokens for recall results
@@ -171,7 +180,7 @@ tools = [HindsightTools(bank_id="user-123")]
 
 | Parameter | Default | Description |
 |---|---|---|
-| `hindsight_api_url` | Production API | Hindsight API URL |
+| `hindsight_api_url` | Hindsight Cloud (`https://api.hindsight.vectorize.io`) | Hindsight API URL |
 | `api_key` | `HINDSIGHT_API_KEY` env | API key for authentication |
 | `budget` | `"mid"` | Default recall budget level |
 | `max_tokens` | `4096` | Default max tokens for recall |

hindsight-docs/docs-integrations/dify.md

@@ -28,6 +28,10 @@ After install, the **Hindsight** plugin appears under **Tools** in the workflow
 
 ## Setup
 
+:::tip Recommended: Hindsight Cloud
+[Sign up free](https://ui.hindsight.vectorize.io/signup) and grab an API key — no self-hosting required.
+:::
+
 1. **Sign up** at [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) (free tier) or [self-host](/developer/installation)
 2. **Get an API key** from the Hindsight dashboard
 3. **In Dify**, open the Hindsight plugin and add credentials:

hindsight-docs/docs-integrations/n8n.md

@@ -35,6 +35,10 @@ Restart n8n; the **Hindsight** node appears in the node panel.
 
 ## Setup
 
+:::tip Recommended: Hindsight Cloud
+[Sign up free](https://ui.hindsight.vectorize.io/signup) and grab an API key — no self-hosting required.
+:::
+
 1. **Sign up** at [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) (free tier) or [self-host](/developer/installation)
 2. **Get an API key** from the Hindsight dashboard
 3. **In n8n**, create a new **Hindsight API** credential with your API URL (defaults to Hindsight Cloud) and the `hsk_...` key

hindsight-docs/guides/2026-05-04-guide-agentcore-memory-with-hindsight.md

@@ -44,6 +44,8 @@ pip install hindsight-agentcore
 
 ## Step 2: Connect AgentCore Runtime to Hindsight
 
+> ✨ **Recommended:** [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) — free tier, no self-hosting required.
+
 ```python
 import os
 from hindsight_agentcore import configure
@@ -54,6 +56,8 @@ configure(
 )
 ```
 
+If you'd rather self-host on AWS (ECS/EKS with RDS PostgreSQL + pgvector), set `hindsight_api_url` to your in-VPC Hindsight endpoint.
+
 ## Step 3: Wire memory into your runtime
 
 ```python

hindsight-integrations/agentcore/README.md

@@ -34,6 +34,8 @@ pip install hindsight-agentcore
 
 ## Quick Start
 
+> ✨ **Recommended: [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup)** — free tier, no self-hosting required. Sign up and grab an API key in under a minute.
+
 ```python
 import os
 from hindsight_agentcore import HindsightRuntimeAdapter, TurnContext, configure

hindsight-integrations/agno/README.md

@@ -18,6 +18,8 @@ pip install hindsight-agno
 
 ## Quick Start
 
+> ✨ **Recommended: [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup)** — free tier, no self-hosting required. Sign up and grab an API key in under a minute.
+
 ```python
 from agno.agent import Agent
 from agno.models.openai import OpenAIChat
@@ -27,7 +29,8 @@ agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
     tools=[HindsightTools(
         bank_id="user-123",
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
+        api_key="hsk_...",  # or set HINDSIGHT_API_KEY env var
     )],
 )
 
@@ -41,6 +44,19 @@ The agent now has three tools it can call:
 - **`recall_memory`** — Search long-term memory for relevant facts
 - **`reflect_on_memory`** — Synthesize a reasoned answer from memories
 
+### Self-hosting (local development)
+
+If you're running Hindsight locally with `./scripts/dev/start-api.sh`, point at your local server instead:
+
+```python
+tools=[HindsightTools(
+    bank_id="user-123",
+    hindsight_api_url="https://api.hindsight.vectorize.io",
+)]
+```
+
+See the [Hindsight installation guide](https://hindsight.vectorize.io/developer/installation) for self-hosting setup.
+
 ## With Memory Instructions
 
 Pre-recall relevant memories and inject them into the system prompt:
@@ -52,11 +68,11 @@ agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
     tools=[HindsightTools(
         bank_id="user-123",
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
     )],
     instructions=[memory_instructions(
         bank_id="user-123",
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
     )],
 )
 ```
@@ -68,7 +84,7 @@ Include only the tools you need:
 ```python
 tools = [HindsightTools(
     bank_id="user-123",
-    hindsight_api_url="http://localhost:8888",
+    hindsight_api_url="https://api.hindsight.vectorize.io",
     enable_retain=True,
     enable_recall=True,
     enable_reflect=False,  # Omit reflect
@@ -87,7 +103,7 @@ The bank ID is resolved in order:
 # Per-user banks from RunContext
 agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
-    tools=[HindsightTools(hindsight_api_url="http://localhost:8888")],
+    tools=[HindsightTools(hindsight_api_url="https://api.hindsight.vectorize.io")],
     user_id="user-123",  # Used as bank_id
 )
 
@@ -99,7 +115,7 @@ agent = Agent(
     model=OpenAIChat(id="gpt-4o-mini"),
     tools=[HindsightTools(
         bank_resolver=resolve_bank,
-        hindsight_api_url="http://localhost:8888",
+        hindsight_api_url="https://api.hindsight.vectorize.io",
     )],
 )
 ```
@@ -112,7 +128,7 @@ Instead of passing connection details to every toolkit, configure once:
 from hindsight_agno import configure, HindsightTools
 
 configure(
-    hindsight_api_url="http://localhost:8888",
+    hindsight_api_url="https://api.hindsight.vectorize.io",
     api_key="your-api-key",       # Or set HINDSIGHT_API_KEY env var
     budget="mid",                  # Recall budget: low/mid/high
     max_tokens=4096,               # Max tokens for recall results
@@ -165,7 +181,7 @@ tools = [HindsightTools(bank_id="user-123")]
 
 | Parameter | Default | Description |
 |---|---|---|
-| `hindsight_api_url` | Production API | Hindsight API URL |
+| `hindsight_api_url` | Hindsight Cloud (`https://api.hindsight.vectorize.io`) | Hindsight API URL |
 | `api_key` | `HINDSIGHT_API_KEY` env | API key for authentication |
 | `budget` | `"mid"` | Default recall budget level |
 | `max_tokens` | `4096` | Default max tokens for recall |

hindsight-integrations/agno/hindsight_agno/__init__.py

@@ -13,11 +13,11 @@ Basic usage::
         model=OpenAIChat(id="gpt-4o-mini"),
         tools=[HindsightTools(
             bank_id="user-123",
-            hindsight_api_url="http://localhost:8888",
+            hindsight_api_url="https://api.hindsight.vectorize.io",
         )],
         instructions=[memory_instructions(
             bank_id="user-123",
-            hindsight_api_url="http://localhost:8888",
+            hindsight_api_url="https://api.hindsight.vectorize.io",
         )],
     )
 

hindsight-integrations/agno/hindsight_agno/tools.py

@@ -96,7 +96,8 @@ class HindsightTools(Toolkit):
             model=OpenAIChat(id="gpt-4o-mini"),
             tools=[HindsightTools(
                 bank_id="user-123",
-                hindsight_api_url="http://localhost:8888",
+                hindsight_api_url="https://api.hindsight.vectorize.io",
+                api_key="hsk_...",
             )],
         )
         agent.print_response("Remember that I prefer dark mode")

hindsight-integrations/dify/README.md

@@ -10,6 +10,8 @@ Three tools — **Retain**, **Recall**, **Reflect** — drop into any Dify workf
 
 ## Setup
 
+> ✨ **Recommended: [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup)** — free tier, no self-hosting required. Sign up and grab an API key in under a minute.
+
 1. **Sign up** at [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) (free tier) or [self-host](https://hindsight.vectorize.io/developer/installation).
 2. **Get an API key** from the Hindsight dashboard.
 3. **In Dify**, install this plugin (Marketplace or upload `.difypkg`), then add credentials:

hindsight-integrations/n8n/README.md

@@ -27,6 +27,8 @@ Restart n8n and the **Hindsight** node appears in the node panel.
 
 ## Setup
 
+> ✨ **Recommended: [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup)** — free tier, no self-hosting required. Sign up and grab an API key in under a minute.
+
 1. **Create a Hindsight account** at [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) (free tier available) — or self-host with the [Hindsight installer](https://hindsight.vectorize.io/developer/installation)
 2. **Get an API key** from the Hindsight dashboard
 3. **In n8n**, create a new **Hindsight API** credential: