The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents and apps. Context that persists. Built for production.
Python agentic-memoryagentic-memory-systemagentsaiai-agentschatgptgenaillmlong-term-memorymemorymemory-managementpythonragstate-management
feat(cli): add email verification code login to mem0 init (#4623)
Kabir Kohliaf19495f664e
diff --git a/cli/CLI_SPECIFICATION.md b/cli/CLI_SPECIFICATION.mdindex 255c8b0b4..171fd280e 100644--- a/cli/CLI_SPECIFICATION.md+++ b/cli/CLI_SPECIFICATION.md@@ -153,8 +153,19 @@ Interactive setup wizard for mem0 CLI.|-----------------|--------|----------|---------|------|| `--api-key` | string | No | - | API key (skip prompt). || `-u, --user-id` | string | No | - | Default user ID (skip prompt). |+| `--email` | string | No | - | Login via email verification code. |+| `--code` | string | No | - | Verification code (use with --email for non-interactive login). |**Behavior:**++*Email login flow (when `--email` is provided):*+- Sends a 6-digit verification code to the email via `POST /api/v1/auth/email_code/`.+- If `--code` is also provided, verifies immediately (fully non-interactive).+- If `--code` is not provided, prompts for the code interactively.+- On success: receives API key, org_id, project_id. Saves to config. Creates account if email is new.+- Cannot be combined with `--api-key`.++*API key flow (existing behavior):*- If both `--api-key` and `--user-id` are provided, runs non-interactively (no prompts).- If running in a non-TTY without both flags, prints an error with usage hint and exits.- Interactive mode: prints banner, prompts for API key (masked with `*`), prompts for default user ID (default: `mem0-cli`), validates connection, saves config.@@ -164,6 +175,8 @@ Interactive setup wizard for mem0 CLI.```bashmem0 initmem0 init --api-key m0-xxx --user-id alice+mem0 init --email [email protected]+mem0 init --email [email protected] --code 482901```---diff --git a/cli/README.md b/cli/README.mdindex 82335dbe1..fbcadd0f2 100644--- a/cli/README.md+++ b/cli/README.md@@ -17,9 +17,15 @@ Both packages install a `mem0` binary with identical behavior.## Quick start```bash-# Authenticate and save config+# Interactive setup wizardmem0 init+# Or login via email (get a new API key)+mem0 init --email [email protected]++# Or authenticate with an existing API key+mem0 init --api-key m0-xxx+# Add a memorymem0 add "I prefer dark mode and use vim keybindings" --user-id alice@@ -40,7 +46,7 @@ mem0 delete <memory-id>| Command | Description ||---------|-------------|-| `mem0 init` | Interactive setup wizard — configures API key and default user ID |+| `mem0 init` | Setup wizard — login via email or configure API key manually || `mem0 add` | Add a memory from text, JSON messages, a file, or stdin || `mem0 search` | Search memories using natural language || `mem0 list` | List memories with optional filters and pagination |diff --git a/cli/cli-spec.json b/cli/cli-spec.jsonindex dc97e2f64..4b6594093 100644--- a/cli/cli-spec.json+++ b/cli/cli-spec.json@@ -503,15 +503,20 @@},{"name": "init",- "description": "Interactive setup wizard for mem0 CLI.",- "usage": "mem0 init",+ "description": "Setup wizard for mem0 CLI. Supports email login (--email) or manual API key (--api-key).",+ "usage": "mem0 init [OPTIONS]","needsBackend": false,"needsConfig": false,"resolveIds": false,"resolveGraph": false,"confirmDangerous": false,"arguments": [],- "options": []+ "options": [+ { "name": "api-key", "flags": ["--api-key"], "type": "string", "default": null, "help": "API key (skip prompt)." },+ { "name": "user-id", "flags": ["-u", "--user-id"], "type": "string", "default": null, "help": "Default user ID (skip prompt)." },+ { "name": "email", "flags": ["--email"], "type": "string", "default": null, "help": "Login via email verification code." },+ { "name": "code", "flags": ["--code"], "type": "string", "default": null, "help": "Verification code (use with --email for non-interactive login)." }+ ]},{"name": "status",diff --git a/cli/node/src/commands/init.ts b/cli/node/src/commands/init.tsindex 590fff041..1ace32d77 100644--- a/cli/node/src/commands/init.ts+++ b/cli/node/src/commands/init.ts@@ -10,11 +10,94 @@ import {printSuccess,colors,} from "../branding.js";-import { type Mem0Config, createDefaultConfig, saveConfig } from "../config.js";+import { type Mem0Config, createDefaultConfig, loadConfig, saveConfig, DEFAULT_BASE_URL } from "../config.js";import { PlatformBackend } from "../backend/platform.js";const { brand, dim } = colors;+const EMAIL_RE = /^[^@\s]+@[^@\s]+\.[^@\s]+$/;++function validateEmail(email: string): void {+ if (!EMAIL_RE.test(email)) {+ printError(`Invalid email address: ${JSON.stringify(email)}`);+ process.exit(1);+ }+}++async function emailLogin(+ email: string,+ code: string | undefined,+ baseUrl: string,+): Promise<Record<string, unknown>> {+ const url = baseUrl.replace(/\/+$/, "");++ if (!code) {+ const resp = await fetch(`${url}/api/v1/auth/email_code/`, {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({ email }),+ signal: AbortSignal.timeout(30_000),+ });+ if (resp.status === 429) {+ printError("Too many attempts. Try again in a few minutes.");+ process.exit(1);+ }+ if (!resp.ok) {+ let detail: string;+ try {+ const body = (await resp.json()) as Record<string, unknown>;+ detail = (body["error"] ?? body["detail"] ?? resp.statusText) as string;+ } catch {+ detail = resp.statusText;+ }+ printError(`Failed to send code: ${detail}`);+ process.exit(1);+ }++ printSuccess("Verification code sent! Check your email.");++ if (!process.stdin.isTTY) {+ printError(+ "No --code provided and terminal is non-interactive.",+ "Run: mem0 init --email <email> --code <code>",+ );+ process.exit(1);+ }++ console.log();+ const entered = await promptLine(` ${brand("Verification Code")}`);+ if (!entered) {+ printError("Code is required.");+ process.exit(1);+ }+ code = entered;+ }++ const verifyResp = await fetch(`${url}/api/v1/auth/email_code/verify/`, {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({ email, code: code.trim() }),+ signal: AbortSignal.timeout(30_000),+ });+ if (verifyResp.status === 429) {+ printError("Too many attempts. Try again in a few minutes.");+ process.exit(1);+ }+ if (!verifyResp.ok) {+ let detail: string;+ try {+ const body = (await verifyResp.json()) as Record<string, unknown>;+ detail = (body["error"] ?? body["detail"] ?? verifyResp.statusText) as string;+ } catch {+ detail = verifyResp.statusText;+ }+ printError(`Verification failed: ${detail}`);+ process.exit(1);+ }++ return verifyResp.json() as Promise<Record<string, unknown>>;+}+function promptSecret(label: string): Promise<string> {return new Promise((resolve, reject) => {process.stdout.write(label);@@ -124,8 +207,57 @@ async function validatePlatform(config: Mem0Config): Promise<void> {}}-export async function runInit(opts: { apiKey?: string; userId?: string } = {}): Promise<void> {+export async function runInit(+ opts: { apiKey?: string; userId?: string; email?: string; code?: string } = {},+): Promise<void> {const config = createDefaultConfig();+ const savedConfig = loadConfig();+ const baseUrl =+ process.env["MEM0_BASE_URL"] || savedConfig.platform.baseUrl || DEFAULT_BASE_URL;++ // Guards+ if (opts.code && !opts.email) {+ printError("--code requires --email.");+ process.exit(1);+ }+ if (opts.email && opts.apiKey) {+ printError("Cannot use both --api-key and --email.");+ process.exit(1);+ }++ // ── Email login flow ──────────────────────────────────────────────────────+ if (opts.email) {+ const email = opts.email.trim().toLowerCase();+ validateEmail(email);++ printBanner();+ console.log();+ printInfo(`Logging in as ${email}...\n`);++ const result = await emailLogin(email, opts.code, baseUrl);++ const apiKeyVal = result["api_key"] as string | undefined;+ if (!apiKeyVal) {+ printError("Auth succeeded but no API key was returned. Contact support.");+ process.exit(1);+ }++ config.platform.apiKey = apiKeyVal;+ config.platform.baseUrl = baseUrl;+ config.defaults.userId = opts.userId || "mem0-cli";++ saveConfig(config);+ console.log();+ printSuccess("Authenticated! Configuration saved to ~/.mem0/config.json");+ console.log();+ console.log(` ${dim("Get started:")}`);+ console.log(` ${dim(' mem0 add "I prefer dark mode"')}`);+ console.log(` ${dim(' mem0 search "preferences"')}`);+ console.log();+ return;+ }++ // ── API key flow ──────────────────────────────────────────────────────────// Non-interactive: both flags providedif (opts.apiKey && opts.userId) {@@ -154,6 +286,49 @@ export async function runInit(opts: { apiKey?: string; userId?: string } = {}):if (opts.apiKey) {config.platform.apiKey = opts.apiKey;} else {+ console.log(` ${brand("How would you like to authenticate?")}`);+ console.log(` ${dim("1.")} Login with email ${dim("(recommended)")}`);+ console.log(` ${dim("2.")} Enter API key manually`);+ console.log();++ const choice = await promptLine(` ${brand("Choose")} [1/2]`, "1");++ if (choice === "1") {+ console.log();+ const emailAddr = await promptLine(` ${brand("Email")}`);+ if (!emailAddr) {+ printError("Email is required.");+ process.exit(1);+ }++ const email = emailAddr.trim().toLowerCase();+ validateEmail(email);+ printInfo(`Logging in as ${email}...\n`);++ const result = await emailLogin(email, undefined, baseUrl);++ const apiKeyVal = result["api_key"] as string | undefined;+ if (!apiKeyVal) {+ printError("Auth succeeded but no API key was returned. Contact support.");+ process.exit(1);+ }++ config.platform.apiKey = apiKeyVal;+ config.platform.baseUrl = baseUrl;+ config.defaults.userId = opts.userId || "mem0-cli";++ saveConfig(config);+ console.log();+ printSuccess("Authenticated! Configuration saved to ~/.mem0/config.json");+ console.log();+ console.log(` ${dim("Get started:")}`);+ console.log(` ${dim(' mem0 add "I prefer dark mode"')}`);+ console.log(` ${dim(' mem0 search "preferences"')}`);+ console.log();+ return;+ }++ // choice === "2": fall through to API key promptawait setupPlatform(config);}diff --git a/cli/node/src/index.ts b/cli/node/src/index.tsindex ea6103322..d4969f5f6 100644--- a/cli/node/src/index.ts+++ b/cli/node/src/index.ts@@ -110,13 +110,18 @@ programprogram.command("init")- .description("Interactive setup wizard for mem0 CLI.")+ .description("Setup wizard for mem0 CLI. Supports email login (--email) or manual API key (--api-key).").option("--api-key <key>", "API key (skip prompt).").option("-u, --user-id <id>", "Default user ID (skip prompt).")- .addHelpText("after", "\nExamples:\n $ mem0 init\n $ mem0 init --api-key m0-xxx --user-id alice")+ .option("--email <email>", "Login via email verification code.")+ .option("--code <code>", "Verification code (use with --email for non-interactive login).")+ .addHelpText(+ "after",+ "\nExamples:\n $ mem0 init\n $ mem0 init --api-key m0-xxx --user-id alice\n $ mem0 init --email [email protected]\n $ mem0 init --email [email protected] --code 123456",+ ).action(async (opts) => {const { runInit } = await import("./commands/init.js");- await runInit({ apiKey: opts.apiKey, userId: opts.userId });+ await runInit({ apiKey: opts.apiKey, userId: opts.userId, email: opts.email, code: opts.code });});// ── Memory: add ───────────────────────────────────────────────────────────diff --git a/cli/python/src/mem0_cli/app.py b/cli/python/src/mem0_cli/app.pyindex c9b1ec076..c329118a3 100644--- a/cli/python/src/mem0_cli/app.py+++ b/cli/python/src/mem0_cli/app.py@@ -695,16 +695,20 @@ app.add_typer(entity_app, name="entity", rich_help_panel="Management")def init(api_key: str | None = typer.Option(None, "--api-key", help="API key (skip prompt)."),user_id: str | None = typer.Option(None, "--user-id", "-u", help="Default user ID (skip prompt)."),+ email: str | None = typer.Option(None, "--email", help="Login via email verification code."),+ code: str | None = typer.Option(None, "--code", help="Verification code (use with --email for non-interactive login)."),) -> None:"""Interactive setup wizard for mem0 CLI.Examples:mem0 initmem0 init --api-key m0-xxx --user-id alice+ mem0 init --email [email protected]+ mem0 init --email [email protected] --code 482901"""from mem0_cli.commands.init_cmd import run_init- run_init(api_key=api_key, user_id=user_id)+ run_init(api_key=api_key, user_id=user_id, email=email, code=code)# (entity_app registered at module level, below sub-group definitions)diff --git a/cli/python/src/mem0_cli/commands/init_cmd.py b/cli/python/src/mem0_cli/commands/init_cmd.pyindex c400f3225..03ec3fa2f 100644--- a/cli/python/src/mem0_cli/commands/init_cmd.py+++ b/cli/python/src/mem0_cli/commands/init_cmd.py@@ -2,8 +2,11 @@from __future__ import annotations+import os+import reimport sys+import httpximport typerfrom rich.console import Consolefrom rich.prompt import Prompt@@ -16,7 +19,7 @@ from mem0_cli.branding import (print_info,print_success,)-from mem0_cli.config import Mem0Config, save_config+from mem0_cli.config import DEFAULT_BASE_URL, Mem0Config, save_configconsole = Console()err_console = Console(stderr=True)@@ -84,7 +87,89 @@ def _prompt_secret(label: str) -> str:return "".join(chars)-def run_init(*, api_key: str | None = None, user_id: str | None = None) -> None:+_EMAIL_RE = re.compile(r"^[^@\s]+@[^@\s]+\.[^@\s]+$")+++def _validate_email(email: str) -> None:+ """Exit with an error if *email* doesn't look like a valid address."""+ if not _EMAIL_RE.match(email):+ print_error(err_console, f"Invalid email address: {email!r}")+ raise typer.Exit(1)+++def _email_login(+ email: str,+ code: str | None,+ base_url: str,+) -> dict:+ """Run the email verification code login flow.++ Returns the parsed JSON response from the verify endpoint.+ The caller expects at minimum an ``api_key`` field.+ """+ url = base_url.rstrip("/")++ with httpx.Client(timeout=30.0) as client:+ # If code is already provided, skip sending — user already has a code+ if not code:+ # Step 1: Request verification code+ resp = client.post(+ f"{url}/api/v1/auth/email_code/",+ json={"email": email},+ )+ if resp.status_code == 429:+ print_error(err_console, "Too many attempts. Try again in a few minutes.")+ raise typer.Exit(1)+ if resp.status_code != 200:+ try:+ detail = resp.json().get("error", resp.text)+ except Exception:+ detail = resp.text+ print_error(err_console, f"Failed to send code: {detail}")+ raise typer.Exit(1)++ print_success(console, "Verification code sent! Check your email.")++ # Step 2: Get code from user+ if not sys.stdin.isatty():+ print_error(+ err_console,+ "No --code provided and terminal is non-interactive.",+ hint="Run: mem0 init --email <email> --code <code>",+ )+ raise typer.Exit(1)+ console.print()+ code = Prompt.ask(f" [{BRAND_COLOR}]Verification Code[/]")+ if not code:+ print_error(err_console, "Code is required.")+ raise typer.Exit(1)++ # Step 3: Verify code+ resp = client.post(+ f"{url}/api/v1/auth/email_code/verify/",+ json={"email": email, "code": code.strip()},+ )+ if resp.status_code == 429:+ print_error(err_console, "Too many attempts. Try again in a few minutes.")+ raise typer.Exit(1)+ if resp.status_code != 200:+ try:+ detail = resp.json().get("error", resp.text)+ except Exception:+ detail = resp.text+ print_error(err_console, f"Verification failed: {detail}")+ raise typer.Exit(1)++ return resp.json()+++def run_init(+ *,+ api_key: str | None = None,+ user_id: str | None = None,+ email: str | None = None,+ code: str | None = None,+) -> None:"""Interactive setup wizard for mem0 CLI.When both *api_key* and *user_id* are supplied, all prompts are skipped@@ -93,6 +178,48 @@ def run_init(*, api_key: str | None = None, user_id: str | None = None) -> None:"""config = Mem0Config()+ base_url = os.environ.get("MEM0_BASE_URL", config.platform.base_url or DEFAULT_BASE_URL)++ if code and not email:+ print_error(err_console, "--code requires --email.")+ raise typer.Exit(1)++ # ── Email login flow ──────────────────────────────────────────────+ if email:+ if api_key:+ print_error(err_console, "Cannot use both --api-key and --email.")+ raise typer.Exit(1)++ email = email.strip().lower()+ _validate_email(email)++ print_banner(console)+ console.print()+ print_info(console, f"Logging in as {email}...\n")++ result = _email_login(email, code, base_url)++ api_key_val = result.get("api_key")+ if not api_key_val:+ print_error(err_console, "Auth succeeded but no API key was returned. Contact support.")+ raise typer.Exit(1)+ config.platform.api_key = api_key_val+ config.platform.base_url = base_url+ config.defaults.user_id = user_id or "mem0-cli"++ save_config(config)++ console.print()+ print_success(console, "Authenticated! Configuration saved to ~/.mem0/config.json")+ console.print()+ console.print(f" [{DIM_COLOR}]Get started:[/]")+ console.print(f' [{DIM_COLOR}] mem0 add "I prefer dark mode"[/]')+ console.print(f' [{DIM_COLOR}] mem0 search "preferences"[/]')+ console.print()+ return++ # ── API key flow (existing) ───────────────────────────────────────+# Fully non-interactive when both flags providedif api_key and user_id:config.platform.api_key = api_key@@ -115,7 +242,47 @@ def run_init(*, api_key: str | None = None, user_id: str | None = None) -> None:console.print()print_info(console, "Welcome! Let's set up your mem0 CLI.\n")- # Use provided flags or prompt+ # If no flags at all, ask user how they want to authenticate+ if not api_key:+ console.print(f" [{BRAND_COLOR}]How would you like to authenticate?[/]")+ console.print(f" [{DIM_COLOR}]1.[/] Login with email [{DIM_COLOR}](recommended)[/]")+ console.print(f" [{DIM_COLOR}]2.[/] Enter API key manually")+ console.print()+ choice = Prompt.ask(f" [{BRAND_COLOR}]Choose[/]", choices=["1", "2"], default="1")++ if choice == "1":+ console.print()+ email_addr = Prompt.ask(f" [{BRAND_COLOR}]Email[/]")+ if not email_addr:+ print_error(err_console, "Email is required.")+ raise typer.Exit(1)++ email_addr = email_addr.strip().lower()+ _validate_email(email_addr)+ print_info(console, f"Logging in as {email_addr}...\n")++ result = _email_login(email_addr, None, base_url)++ api_key_val = result.get("api_key")+ if not api_key_val:+ print_error(err_console, "Auth succeeded but no API key was returned. Contact support.")+ raise typer.Exit(1)+ config.platform.api_key = api_key_val+ config.platform.base_url = base_url+ config.defaults.user_id = user_id or "mem0-cli"++ save_config(config)++ console.print()+ print_success(console, "Authenticated! Configuration saved to ~/.mem0/config.json")+ console.print()+ console.print(f" [{DIM_COLOR}]Get started:[/]")+ console.print(f' [{DIM_COLOR}] mem0 add "I prefer dark mode"[/]')+ console.print(f' [{DIM_COLOR}] mem0 search "preferences"[/]')+ console.print()+ return++ # API key flowif api_key:config.platform.api_key = api_keyelse: