memento/.env.sample at main · latentsignal-org/memento · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
# Memento configuration.
# Copy to .env and fill in the values you need.
#
# For a release binary, only the Quick Start section below is needed to
# unlock AI-powered generation. Demo mode (`./memento app --demo`) works
# without any configuration at all.

# ── Quick Start ──────────────────────────────────────────────────────────────
# Set these three to use AI-powered generation.
# Providers: gemini, openai_compatible, fake (offline testing only)
MEMENTO_MODEL_PROVIDER=gemini
MEMENTO_MODEL_API_KEY=
MEMENTO_AGENT_MODEL=gemini-3.5-flash

# ── msgvault archive ──────────────────────────────────────────────────────────
# Memento auto-detects msgvault at ~/.msgvault/msgvault.db (or the data_dir
# in ~/.msgvault/config.toml). Override only if your archive is elsewhere.
# MEMENTO_MSGVAULT_DB=/path/to/msgvault.db
# MEMENTO_MSGVAULT_HOME=/path/to/msgvault-data-dir/

# Optional: connect to a running `msgvault serve` for richer search and
# concurrent reads. Start msgvault in a second terminal and set this to the
# URL it prints. Leave blank to use direct SQLite reads instead.
# MEMENTO_MSGVAULT_API_URL=http://127.0.0.1:4747
# MEMENTO_MSGVAULT_API_KEY=

# ── Alternative LLM providers ────────────────────────────────────────────────
# Official OpenAI API (Responses API + optional reasoning effort)
# MEMENTO_MODEL_PROVIDER=openai_compatible
# MEMENTO_MODEL_BASE_URL=https://api.openai.com/v1
# MEMENTO_MODEL_API_KEY=your_openai_api_key
# MEMENTO_AGENT_MODEL=o3-mini
# MEMENTO_MODEL_REASONING_EFFORT=medium

# Local LLM — Ollama, vLLM, LM Studio (model must support tool calls)
# MEMENTO_MODEL_PROVIDER=openai_compatible
# MEMENTO_MODEL_BASE_URL=http://127.0.0.1:11434/v1
# MEMENTO_MODEL_API_KEY=ollama
# MEMENTO_AGENT_MODEL=gemma4:e4b

# DeepSeek V4 / OpenCode Zen
# MEMENTO_MODEL_PROVIDER=openai_compatible
# MEMENTO_MODEL_BASE_URL=https://opencode.ai/zen/v1
# MEMENTO_MODEL_API_KEY=your_opencode_zen_key
# MEMENTO_AGENT_MODEL=deepseek-v4-flash-free
# MEMENTO_MODEL_THINKING=enabled
# MEMENTO_MODEL_REASONING_EFFORT=max
# MEMENTO_MODEL_REPLAY_REASONING=1

# Cerebras AI cloud inference
# MEMENTO_MODEL_PROVIDER=openai_compatible
# MEMENTO_MODEL_BASE_URL=https://api.cerebras.ai/v1
# MEMENTO_MODEL_API_KEY=your_cerebras_api_key
# MEMENTO_AGENT_MODEL=gpt-oss-120b

# ── Advanced agent tuning ─────────────────────────────────────────────────────
# These rarely need changing. Defaults are shown.
# MEMENTO_AGENT_STEP_LIMIT=20
# MEMENTO_AGENT_STALE_AFTER_MS=120000
# MEMENTO_AGENT_DECISION_TIMEOUT_MS=90000
# MEMENTO_AGENT_CONTEXT_LIMIT_TOKENS=128000
# MEMENTO_AGENT_VERBOSE_LOGS=
# MEMENTO_REFRESH_TRACE=

# Per-agent model overrides (leave blank to inherit MEMENTO_AGENT_MODEL)
# MEMENTO_COLLECTOR_MODEL=
# MEMENTO_PROJECT_MODEL=
# MEMENTO_CONCEPT_MODEL=
# MEMENTO_PERSON_MODEL=
# MEMENTO_MEMENTO_MODEL=

# ── Development only ──────────────────────────────────────────────────────────
# These are only read when running `pnpm dev` (frontend development).
# Release binaries ignore them.
#
# URL the Next.js dev proxy forwards /api/* calls to.
# MEMENTO_BACKEND_URL=http://127.0.0.1:8787
#
# Serve the web UI from a directory on disk instead of the embedded copy
# (useful when iterating on the frontend without rebuilding the binary).
# MEMENTO_WEB_DIR=./out
#
# Additional origins accepted by the Go CORS middleware during local dev
# (comma-separated, e.g. http://localhost:3001).
# MEMENTO_ALLOWED_DEV_ORIGINS=